Remodex — Remote Control for Codex

What it is

Remodex is an open-source local-first bridge that pairs a Mac running Codex CLI with an iPhone app. It enables users to control and interact with Codex remotely from their iPhone, sending instructions and receiving real-time responses over a secure, encrypted session.

Main Features

Remote Agent Control

• Send instructions to Codex running on a Mac from an iPhone.
• Responses stream back in real time through the bridge.
• Phone initiates commands while the Mac executes them.

Secure Pairing and Encryption

• End-to-end encrypted channel using X25519, Ed25519, AES-256-GCM, and replay protection.
• Pairing established via QR code scanned inside the iOS app after running remodex up on the Mac.

Git and Terminal Access

• Perform git actions locally on the Mac via the bridge: status, commit, push, pull, branches, checkout, stash, log.
• Open native SSH sessions from the iPhone; SSH key material remains in the iOS Keychain.

Self-Hosting and Relay Options

• Can point to a self-hosted relay using the REMODEX_RELAY environment variable.
• Includes a ./run-local-remodex.sh script for running from source.
• Tailscale recommended for iPhone self-hosting over a private network.

How it works

Installation and Pairing

1. Install the bridge globally on the Mac: npm i -g remodex@latest
2. Start the bridge with remodex up
3. Open the Remodex iOS app on the iPhone, follow onboarding, and scan the QR code displayed in the terminal (using the app’s scanner, not the Camera app).

Background Persistence

• On macOS, the bridge can continue running in the background via launchd, allowing trusted reconnects even after closing the terminal.
• On other operating systems, the foreground bridge stops when the terminal closes.

Key Points

• Requires Node.js 18+, Codex CLI installed and logged in on the Mac, and the Remodex iOS app.
• Remodex does not manage OpenAI credentials – Codex must already be functional on the Mac.
• Session files are stored in ~/.codex/sessions; the Codex.app desktop client is not a real-time mirror and may lag without manual refresh.
• The relay transport can see connection metadata but not decrypted application payloads after the secure handshake.

Additional Details

• Free to download on iOS; Android beta is also available.
• Licensed under Apache 2.0; source code available on GitHub.
• Privacy policy and terms of service link are provided on the website.
• Community size indicated: 3.1K downloads.