0xwilliamortiz
Featured
openclaude-improved
OpenClaude is an open-source CLI coding agent that runs on any platform and supports a wide range of LLM providers, offering the same tools and workflows as Claude Code.
AI repository intelligence
FR-AI / ANALYSISWhy it is worth attention
It bridges physical game controllers with terminal-based AI coding tools, offering a novel hands-on interaction paradigm that can speed up repetitive actions and improve ergonomics for developers.
Who it is for
- Developers using Claude Code or Codex CLI
- Developers who prefer physical controllers over keyboard/mouse
- Developers with accessibility needs seeking alternative input methods
- Developers working in multi-session environments like herdr
Use cases
- Reviewing PRs with a stick flick
- Switching between coding sessions using touchpad click
- Controlling reasoning effort level via right-stick flicks
- Executing common agent actions (submit, interrupt, dictate) without keyboard
Strengths
- Supports multiple controllers including DualSense, GameSir G7 Pro, and generic HID
- Remappable six-layer control scheme for custom workflows
- Integrated with herdr for workspace and agent management
- Public APIs for adding custom harnesses and embedding controller input
Considerations
- macOS-only; other platforms untested
- Controller compatibility varies by device and connection; not all features work on all controllers
- Thinking-depth dial requires manual keyboard shortcut setup in Codex app
README quick start
One controller. Your agent workflow.
Bring Codex Micro to any gaming controller and coding harness
Start in 60 seconds
You need macOS, Node.js 22 or newer, Claude Code or Codex CLI, and a connected controller. OpenMicro is macOS-first; other platforms are not yet tested.
npm i -g openmicro
openmicro claude # or just: openmicro
openmicro codex
openmicro codex-app # drive the Codex macOS desktop app
openmicro codex-app drives the Codex desktop app instead of a terminal CLI: new chat and prompt prefill use codex:// deep links (no permission needed), while submit (Enter), reject (Esc), dictation (Ctrl+Shift+D), d-pad arrows, and Ctrl+U send keystrokes and need Accessibility permission for your terminal. A stick-flick prompt prefills the composer; press submit to send it. The app launches automatically and the terminal shows live status (controller, actions, agent state).
The thinking-depth dial (right-stick flicks) needs one-time setup: the app ships "Increase reasoning effort" and "Decrease reasoning effort" shortcuts unassigned, and assignments are account-synced so OpenMicro cannot set them for you. In the Codex app open Settings → Keyboard shortcuts, search "effort", and assign Increase to ⌃⌥= (Control+Option+=, Ctrl+Alt on Windows) and Decrease to ⌃⌥- — right-stick flicks then step the composer's reasoning effort. These chords avoid the app's Ctrl/Cmd +/- zoom shortcuts. Note the app's own Decrease shortcut stops one step short of the lowest effort level (also when pressed physically) — use the model picker for that. Optionally also assign "Open model picker" to ⌃⇧M — right-stick click then opens the picker so you can watch the effort change. Assigned different chords? Remap thinking_depth in your OpenMicro config to matching keys bindings.
OpenMicro installs its lifecycle hooks automatically. If Codex reports that its hooks changed, open /hooks in Codex and trust the OpenMicro hooks.
Controller support depends on the exact device and connection. Check the controller compatibility guide before you start, or run openmicro doctor to test your controller.
Default controls
| DualSense | GameSir G7 Pro | | :---------------------------------------------
Description
🎮 Codex Micro functionality using any Gaming Controller on any Coding Harness!
Related repositories
Similar projects matched by category, topics, and programming language.
makecindy
Featured
cindy
Cindy is an open-source AI agent that runs locally on your machine, integrates multiple AI harnesses and models, and provides memory, skills, and automation to perform real work in your projects and apps.
S40911120
Featured
recensa
Recensa is a self-hosted web viewer that indexes Claude Code session transcripts into a local SQLite database, enabling full-text search, replay, and audit of all past agent conversations without uploading data anywhere.