Remodex — Remote Control for Codex

Remodex Showcase Setup FAQ 3.1K Download Control Agents

From your iPhone

Download on iOS Android Beta Eight ways in

One app. All your work.

Two moves

Install and pair

01 Install the bridge $ npm i -g remodex@latest 02 Pair from the app $ remodex up Questions

Before you pair

What is Remodex? +

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.

What do I need before I start? +

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.

How do I install and pair? +

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.

Is it private and secure? +

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.

Can the relay read my prompts or code? +

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.

What happens if I close the terminal? +

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.

Can I use git or terminal from my iPhone? +

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.

Can I self-host it? +

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.

Do phone threads appear in Codex.app? +

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.

Your Mac runs

Your iPhone steers

Download on iOS Android Beta Remodex GitHub Privacy Terms Apache 2.0