gronxb/codex-relay
Use Codex from your phone while the real work stays on your computer.
What it solves
Codex Relay provides a way to interact with the Codex CLI on a computer from a mobile device. It allows users to monitor and steer AI-driven coding sessions without needing to be physically present at their workstation, while ensuring that the actual code execution and session state remain securely on the local machine.
How it works
The system consists of a local relay server (run via Node.js) and a paired mobile app. The relay server acts as a intermediary that connects the mobile app to the Codex CLI session on the computer. Pairing is handled via QR codes and an approval process. The relay can run in a standalone mode or a shared mode that allows a terminal TUI to share the same session with the mobile app.
Who it’s for
Developers who use the Codex CLI and want the flexibility to review code changes, send prompts, and respond to AI requests for input or approval from their phones.
Highlights
- Local-first architecture: Code, shell, and git state stay on the computer; the phone only communicates with the local relay.
- Remote steering: Send prompts, continue threads, and provide approvals from a mobile device.
- Workspace previews: View git changes, local web output, and terminal surfaces directly on mobile.
- Push notifications: Receive alerts for completed turns or when the AI requires user action.
- Tailscale integration: Simplified secure networking for accessing the relay and web previews across different networks.
Related
- Dispatch
- Project
- Project
- Project
- Project