开源的手柄开发控制层

用手柄,控制 Coding Agent。

把常用动作、会话切换和审批确认放回双手。

查看 GitHub
黑色游戏手柄用于控制 Coding Agent
AgentCodex CLI / Codex App / Claude Code
手柄GameSir / Xbox / DualSense / DS4 / 通用 HID
运行方式本地服务 / 无遥测 / 浏览器模拟

少碰键盘,保持思路

按钮负责确定动作,摇杆负责选择上下文。映射可编辑,也能按项目切换。

A / Cross提交。等待审批时按住 500ms
B / Circle中断或关闭
X / Square新建会话
Y / Triangle语音输入
方向键导航 Agent UI
左摇杆Review / Debug / Refactor / Tests
右摇杆调整推理深度
Home / Touchpad切换 Agent 会话

六层配置可以组合 L1 与面键或方向键。

状态不再藏在终端里

本地 HUD 同时显示按键映射、当前 Agent、执行状态和多个会话。鼠标、触摸与键盘都能模拟真实手柄事件。

CodingMacro 本地手柄与 Agent 状态面板
Dashboard 仅绑定 127.0.0.1。模拟器默认关闭。

从菜单栏开始,不打断工作流

macOS 菜单栏应用负责启动、停止、打开 Dashboard 和运行手柄 Doctor。终端用户也可以直接使用 CLI。

启动

选择 Codex App、Codex CLI 或 Claude Code。

映射

在 Dashboard 导入、编辑或导出手柄配置。

验证

没带手柄时先用浏览器模拟,接上设备后运行 doctor。

先兼容常见设备,再欢迎社区补全

GameSir Cyclone 2、G7 Pro、Xbox One S 与 DualSense 已有录制数据回放测试。通用 HID 驱动提供尽力兼容。

GameSirXboxDualSenseDS4HID

真正的开源控制层

MIT 许可。配置、驱动与 Agent 适配都在仓库里。基于 OpenMicro,保留原作者版权与 NOTICE。

NOTICE.md

装上就能试

需要 macOS 和 Node.js 22+。安装器会安装 CLI,并打开 CodingMacro 菜单栏应用。

没带手柄:codingmacro --simulate codex-app接上手柄:codingmacro doctor
Terminalzsh
curl -fsSL https://github.com/MisterBrookT/CodingMacro/raw/refs/heads/main/install.sh | sh

双手留在手柄上,思路留在代码里。

先用模拟器完成映射,再接入你的手柄。所有控制都走同一条事件管线。

查看 GitHub