Codex Relay provides a mobile companion for the Codex CLI, enabling users to interact with their AI coding sessions from their phones while keeping all code, shell, and sensitive data local on their computers. This independent project targets developers using Codex CLI who need convenient mobile access for monitoring and steering AI tasks without compromising data privacy or security.

How It Works

The project runs a local relay server on the user's workspace, which pairs with a mobile application over a private network. It streams Codex output to the paired device, allowing users to send prompts, continue conversations, and approve inputs remotely. The core design is local-first, ensuring that all code, git state, and AI session data remain on the user's machine, with the mobile app communicating solely with the local relay.

Quick Start & Requirements

• Primary install/run command: npx codex-relay@latest
• Prerequisites: Node.js 22.14 or newer, Codex CLI installed and signed in, Codex Relay mobile app, and a network path from the phone to the computer (e.g., same Wi-Fi or Tailscale).
• Setup: Start the relay, then pair the mobile app by scanning a QR code or pasting a link. Approve the pairing request on the computer.
• Links: No explicit documentation or demo links are provided in the README.

Highlighted Details

• Stream Codex output and control sessions from a mobile device.
• Review active threads, queued inputs, approvals, and workspace state remotely.
• Preview git changes, local web output, files, and terminal surfaces from the mobile app.
• Supports secure local web app previews via tailscale serve to overcome App Transport Security requirements.
• All pairing and session data are stored locally under the relay's state.

Maintenance & Community

Codex Relay is an independent project and is not affiliated with OpenAI. The project encourages using English for GitHub issues and discussions. No specific community channels (like Discord or Slack) or notable contributors are mentioned in the provided text.

Licensing & Compatibility

The project is licensed under the Apache License 2.0. However, the Codex Relay name, logos, app icons, screenshots, and other brand assets are not included under this license and are subject to separate trademark terms. The Apache 2.0 license generally permits commercial use and integration into closed-source projects.

Limitations & Caveats

Network connectivity is a primary potential failure point, requiring careful setup to ensure the phone can reach the relay URL. For local web app previews, specific network configurations like tailscale serve may be necessary to enforce HTTPS, especially on iOS. The project's independence from OpenAI means it relies on the stability and availability of the external Codex CLI.