gronxb/codex-relay

What it solves

Codex Relay allows users to monitor and control their Codex CLI sessions from a mobile device. It solves the problem of needing to be physically at a computer to provide input, approve actions, or check the progress of AI-driven coding tasks.

How it works

It runs a local relay server in the user's workspace that pairs with a mobile app over a local network (or via tools like Tailscale). The relay acts as a bridge, streaming Codex output to the phone and sending prompts or approvals back to the computer. To maintain security and privacy, it is designed as a local-first system where code and session data remain on the computer, and the phone only communicates with the local relay.

Who it’s for

Developers who use the Codex CLI and want to steer their AI coding sessions, review git changes, or respond to input requests while away from their desk.

Highlights

• Remote Steering: Send prompts, continue threads, and respond to Codex input requests from a phone.
• Local-First Privacy: Code, shell, and git state stay on the computer; the phone only talks to the local relay.
• Workspace Previews: View git changes, local web output, files, and terminal surfaces on mobile.
• Push Notifications: Receive alerts for completed turns or when action is required.
• Shared Sessions: Ability to sync a mobile session with a terminal TUI using a shared app-server.