Control Agents

Remodex is a local-first open-source Mac bridge plus iOS app. Codex runs on your Mac; your iPhone pairs over a secure session and sends instructions through the bridge while responses stream back in real time.

You need Node.js 18+, Codex CLI installed and logged in on your Mac, and the Remodex iOS app on your iPhone. Remodex does not manage OpenAI credentials; Codex must already work on the Mac.

Run `npm i -g remodex@latest`, then `remodex up` on your Mac. Open the Remodex app on your iPhone, follow onboarding, and scan the QR from inside the app — not with the Camera app, or iOS may treat it as plain text.

Yes. After pairing, app messages use an authenticated end-to-end encrypted channel with X25519, Ed25519, AES-256-GCM, and replay protection. Codex, git, and workspace actions still run on your Mac.

The transport can see connection metadata and handshake control messages, but not decrypted application payloads after the secure handshake succeeds. If you want the tightest trust model, run your own relay.

On macOS, Remodex can keep the bridge running in the background through launchd, so trusted reconnect keeps working. On other operating systems, the foreground bridge stops when the terminal stops.

Yes. Git actions run locally on your Mac through the bridge, including status, commit, push, pull, branches, checkout, stash, and log. Remodex can also open a native SSH session from iPhone; key material stays in the iOS Keychain.

Yes. The repo is self-host friendly. Point `REMODEX_RELAY` at your own relay, or use `./run-local-remodex.sh` from a source checkout. For iPhone self-hosting, Tailscale is the recommended private-network path.

The phone session is live, but Codex.app is not a real-time mirror. It reads session files from `~/.codex/sessions`, so it may lag unless you use the in-app handoff or enable the optional refresh workaround.