为什么值得关注

它将实体游戏手柄与终端 AI 编程工具连接起来，提供新颖的动手交互方式，能加快重复操作并改善开发者的工效学体验。

适合谁使用

使用 Claude Code 或 Codex CLI 的开发者
偏好物理手柄而非键盘鼠标的开发者
需要替代输入方式的无障碍需求开发者
在 herdr 等多会话环境中工作的开发者

典型使用场景

通过摇杆轻扫来审查 PR
使用触摸板点击切换编程会话
通过右摇杆轻扫控制推理努力级别
无需键盘即可执行常见代理操作（提交、中断、语音）

项目优势

支持包括 DualSense、GameSir G7 Pro 及通用 HID 在内的多种手柄
可重映射的六层控制方案，适合自定义工作流
与 herdr 集成，支持工作区和代理管理
提供公共 API 用于添加自定义 harness 和嵌入控制器输入

使用前须知

仅支持 macOS；其他平台未经测试
控制器兼容性因设备和连接方式而异，并非所有功能在所有控制器上都可用
在 Codex 应用中需要手动设置键盘快捷键才能使用推理深度拨盘功能

README 快速开始

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 | | :---------------------------------------------

项目描述

🎮 Codex Micro functionality using any Gaming Controller on any Coding Harness!

OpenMicro