Kappaemme-git /
microdex
An iPhone app that remotely controls the Codex desktop app running on your Mac
- 68 stars
- 2 stars since 3 Oct
- JavaScript
- Updated 2 months ago
- Some experience
- Coding agents & dev tools
Codex runs on your Mac, so you normally have to sit at it to watch tasks or approve actions. Microdex puts a control panel on your iPhone, modelled on the layout of the Codex Micro hardware: six task keys, six command keys, a joystick and a reasoning dial. It is an independent community project, not made by OpenAI or Work Louder.
It has two parts. A CLI called microdex-cli runs a bridge on the Mac. The bridge starts the Codex App Server that ships with the Codex app and talks to it over a local connection. The iPhone app pairs with the bridge by scanning a QR code. Traffic goes through a Cloudflare relay, so the phone works on Wi-Fi or mobile data and you open no router ports.
The README says commands and task state are encrypted between phone and Mac, so the relay only sees ciphertext. The bridge does not ask for your OpenAI credentials. An optional native mode makes Codex see a synthetic Micro device, for closer parity with the physical keyboard.
What it does
Remote task control
Reads your six most recent Codex tasks, sends or steers messages, follows live task state, and opens a task on the desktop.
Approvals and settings
Resolve approval requests, fork conversations, and change Fast Mode and reasoning level for the selected task from the phone.
Encrypted pairing
Each pairing creates a new 256-bit key carried in the QR URL fragment. The pairing code expires after 10 minutes, and
microdex revoke-allresets every paired phone.Background bridge on the Mac
microdex setupinstalls a macOS LaunchAgent so the bridge starts at login and keeps the same relay address across restarts.Explore without a Mac
A local walkthrough with fictional tasks lets you try the interface before pairing. It contacts no Mac or server.
What you could build
- Approve a Codex permission request from your phone while away from your desk.
- Send a follow-up instruction to a running Codex task from the couch or on the go.
- Switch Fast Mode or reasoning level on a task without going back to the Mac.
- Watch live status of your recent Codex tasks over mobile data.
- Emulate a Codex Micro with the optional native mode, with no hardware.
Get started
You need macOS, Node.js 20.19+, and Codex installed and logged in. Install the CLI and run setup, which shows a pairing QR. Then open the Microdex app on your iPhone, tap Pair Mac and scan the code.
npm install --global microdex-cli@latestmicrodex setupCommands are copied from the project's README. Read it on GitHub for the full setup.
More in Coding agents & dev tools
rea
MCP server that lets AI agents reverse engineer apps, binaries and websites locally
opencode
Open source AI coding agent for your terminal, with a beta desktop app
claude-code
Terminal coding assistant that reads your codebase and takes plain-English commands
codex
A coding agent from OpenAI that runs in your terminal on your own machine
pi
A minimal terminal coding agent you extend with skills, extensions and packages
orca
Desktop and mobile app for running many coding agents side by side
Understand-Anything
Turns a codebase or wiki into an interactive graph you can search and ask questions about
screenshot-to-code
Turns screenshots, mockups and screen recordings into front-end code with AI models
warp
Rust terminal that adds a built-in coding agent and runs other CLI agents
free-claude-code
Local proxy that lets Claude Code, Codex, Aider and others run on free or cheap models