gantrol/agentcontroller — explained in plain English
Analysis updated 2026-05-18
Navigate and control Codex tasks entirely from an Xbox, 8BitDo, or Flydigi gamepad.
Use push-to-talk voice dictation into Codex by holding a controller trigger.
Simulate the Codex Micro's hardware dial and keys without owning the physical device.
Preview controller-based Codex control on macOS via the Avalonia-based foundation build.
| gantrol/agentcontroller | fcsvorfeed/aces-1.3-reference-gamut-compression-for-unity-6-urp | avaoqkyk1284130/roblox-collection-executor-pc-2026-version | |
|---|---|---|---|
| Stars | 30 | 30 | 31 |
| Language | C# | C# | C# |
| Setup difficulty | moderate | moderate | moderate |
| Complexity | 3/5 | 3/5 | 3/5 |
| Audience | developer | developer | general |
Figures from each repo's GitHub metadata at analysis time.
The app and its optional Micro-simulation driver are unsigned, so Windows SmartScreen warns before you can run it.
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.
Lets you control the Codex desktop app with a standard game controller instead of buying the dedicated Codex Micro keyboard.
Mainly C#. The stack also includes C#, Avalonia, Windows.
Setup difficulty is rated moderate, with roughly 30min to a first successful run.
Mainly developer.
This repo across BitVibe Labs
Don't trust strangers blindly. Verify against the repo.