gantrol/agentcontroller

Agent Controller lets you drive the Codex desktop app with a game controller instead of the Codex Micro, a small dedicated keyboard for Codex that sold out quickly. The README makes its case with a bit of humor: the Micro has one dial and one stick and twelve keys, while an ordinary gamepad has more controls, costs less, and does not need to be shipped to you. The app maps controller inputs to Codex actions. The left stick walks a task tree, moving between sibling tasks or entering and leaving projects, while A opens a task. The right stick emulates the Codex Micro's rotary encoder for cycling through items. Holding the left trigger starts voice dictation, X sends a message, Y clears the composer, and B held for three seconds cancels an active turn. A Menu button wakes or brings Codex to the foreground. A dashboard included with the app shows an interactive guide to these mappings, switching tutorial tabs in real time as you press the matching controller input. The project also bundles an integrated Codex Micro surface, a simulated version of the physical device hosted inside the same executable, though it depends on an unsigned developer driver package that must be signed locally or built from source. The README includes a clear security notice: this is experimental, one-day-prototype software with no independent security audit, the app and driver are unsigned, and it can send HID reports to the simulated Micro device, read local Codex task data, and optionally add keybindings to Codex's configuration file. It makes no network requests beyond opening links in a browser, and it is not affiliated with OpenAI, Codex, or Work Louder. Agent Controller requires Windows 10 or 11, the Codex desktop app, an XInput-compatible controller, and a microphone for dictation. It has been tested with an 8BitDo Ultimate 2, an Xbox Series controller, and a Flydigi Vader 4 Pro, with other XInput controllers expected to work but not all validated. A separate, read-only macOS 14+ preview built with Avalonia can detect the Codex CLI and observe Apple Game Controller input, but does not yet send actions to Codex. Installation is a zip download from Releases, because the binary is unsigned, Windows SmartScreen will warn before running it.