Emanuele-web04/remodex

What it solves

Remodex provides a way to remotely control the OpenAI Codex runtime on a Mac from an iPhone. It solves the problem of needing to be physically present at a computer to interact with an AI coding agent, allowing users to steer active runs, queue prompts, and manage Git operations from their mobile device.

How it works

The system consists of a local bridge (Node.js) and an iOS app. The bridge runs on the Mac, spawning a Codex app-server and handling communication via a WebSocket bridge. The iPhone pairs with the Mac using a one-time QR code bootstrap, establishing an end-to-end encrypted session. Once paired, the iPhone sends instructions to the bridge, which then interacts with the local Codex CLI and the filesystem/Git on the Mac.

Who it’s for

Developers who use Codex and want the ability to monitor and control their AI coding tasks from their phone, whether they are away from their desk or simply prefer a mobile interface for high-level steering.

Highlights

• Remote Git Control: Perform commits, pushes, pulls, and branch switching directly from the iPhone.
• Secure Pairing: End-to-end encrypted chats and pairing using X25519 ephemeral keys and AES-256-GCM.
• Flexible Execution Modes: Includes a "Fast mode" for low latency and a "Plan mode" for structured planning.
• Local-First Architecture: Keeps the Codex runtime and workspace on the Mac, ensuring the iOS app does not embed public hosted endpoints.
• Subagent Management: Ability to spawn subagents via the /subagents command from the mobile app.
• ** uma macOS Background Service**: Integrates with launchd for automatic reconnects and background operation on macOS.