KeySwitch
macOS keyboard layer

Control Codex
from your keyboard.

Hold Fn + Control to use the Codex Micro controls from your Mac keyboard. Release the shortcut to return to normal typing.

Download for macOS See it in action

macOS 14+ · Apple silicon and Intel

KeySwitch
Dark KeySwitch HUD showing agents on 1–6 and commands on Q–R Light KeySwitch HUD showing agents on 1–6 and commands on Q–R
1Agent 1
QFast mode
I J K LStick
Layer active
Native macOS app
Runs locally
Editable mappings
Automatic updates
Open source
How it works

Codex Micro controls
without extra hardware.

KeySwitch maps the physical controls Codex already understands to the keyboard already under your hands.

See all six agents.

Live menu-bar indicators show idle, thinking, complete, input-needed, and error states without opening another window.

Use it only when needed.

Hold or toggle your activation shortcut. The layer can close automatically after inactivity, and Esc closes it immediately.

Actions stay in Codex.

Change a Micro keycap or action in Codex and KeySwitch updates its HUD. KeySwitch maps Mac keys to the corresponding Micro controls.

Private by default.

KeySwitch has no account, analytics, or telemetry. The HUD does not take keyboard focus and closes when the layer exits.

✓ Input stays on your Mac ✓ Connects only to Codex on this Mac ✓ Optional launch at login ✓ Signed in-app updates
HUD preview

Choose the HUD size and appearance.

Try the four sizes in light or dark mode.

KeySwitch Fri 9:41
Resizable dark KeySwitch HUD preview Resizable light KeySwitch HUD preview
Fn + Control to activate
Default mapping

Start with these keys.
Change any of them later.

1Agent 1
2Agent 2
3Agent 3
4Agent 4
5Agent 5
6Agent 6
QFast
WApprove
EReject
RFork
SpacePush to talk
Right CommandSubmit
I J K LStick directions
Tab / Backtick / Left ShiftDial controls
01 Activate with Fn + Control, or choose another shortcut.
02 Control agents, commands, the stick, the dial, and push-to-talk.
03 Exit by releasing the shortcut, pressing Esc, or waiting for auto-exit.
Open source under MIT

Read the code.
Contribute a change.

The source code, architecture notes, privacy details, and issue tracker are available on GitHub.

View on GitHub Contribute
architecture
1. Press a mapped key
2. KeySwitch sends the matching Micro control
3. Codex performs the selected action

Try KeySwitch on your Mac.

Use Codex Micro controls without buying another keyboard.

Download for macOS