Remodex offers a local-first open-source bridge and iOS application designed to enable users to control the Codex AI runtime on their Mac from their iPhone. It addresses the need for secure, remote interaction with AI coding assistants, providing features like end-to-end encrypted communication, real-time control over active sessions, and the ability to perform Git operations directly from a mobile device. This project is targeted at developers and power users seeking enhanced flexibility and control over their AI-assisted coding workflows without compromising security or data privacy.

How It Works

The system comprises a Node.js-based WebSocket bridge running on the Mac and a SwiftUI iOS application. The bridge connects to a relay server (either hosted or self-hosted) for initial pairing and session establishment. Once paired via a QR code scanned by the iOS app, a secure, end-to-end encrypted channel is established directly between the iPhone and the Mac bridge. The bridge then translates commands from the iOS app into JSON-RPC calls for the Codex application server and handles local execution of Git commands, ensuring that sensitive operations remain on the user's machine. This architecture prioritizes local execution and security, with the relay only handling metadata and encrypted traffic.

Quick Start & Requirements

• Primary install / run command: npm install -g remodex followed by remodex up on your Mac.
• Non-default prerequisites and dependencies: Node.js v18+, Codex CLI installed and in PATH. macOS is required for desktop refresh features. Xcode 16+ is needed if building the iOS app from source. The Remodex iOS app must be installed via TestFlight before pairing.
• Links: CONTRIBUTING.md is mentioned for contribution details.

Highlighted Details

• End-to-end encrypted pairing and chat sessions between iPhone and Mac.
• Direct remote control of Git operations, including commit, push, pull, and branch switching.
• Local-first execution for Codex runtime, Git operations, and workspace actions.
• Automatic reconnection with exponential backoff and secure message re-sending upon connection drops.
• Persistence of Codex threads, allowing resumption on the Mac desktop app.

Maintenance & Community

This project is in its very early stages, with the developer explicitly stating, "I am not actively accepting contributions yet." No community links (e.g., Discord, Slack) or specific roadmap details are provided in the README.

Licensing & Compatibility

The project is licensed under the ISC license, which is a permissive open-source license. This license generally allows for commercial use, modification, and distribution without significant restrictions, making it compatible with closed-source applications.

Limitations & Caveats

The project is described as "very early" and users should "expect bugs." Desktop refresh features, such as auto-refreshing the Codex desktop app, are macOS-only. The Codex desktop app does not live-reload session data written by external processes, requiring manual workarounds or enabling a disruptive deep-link bounce for updates. Contributions are not actively accepted at this time.