Use your phone as a remote workbench for Codex running on your Mac.
Codex Remote is an independent open-source project. It is not affiliated with or endorsed by OpenAI. Codex and OpenAI are trademarks of their respective owners.
Warning
Codex Remote is pre-release software. The current public Beta is limited to Apple Silicon Macs and same-network iPhone Safari access. It is unsigned, not Apple notarized, and must not be exposed directly to the public internet.
flowchart LR
Phone["iPhone App / Mobile Web"] --> Gateway["Mobile Web Gateway"]
Gateway --> Relay["Relay + Run Server"]
Relay --> Agent["Mac Agent"]
Agent --> Codex["Codex App Server"]
Relay --> Runtime[("PostgreSQL + Valkey")]
Admin["Admin Platform"] -. diagnostics .-> Relay
Distribution["Runtime Distribution"] --> Gateway
Distribution --> Relay
Distribution --> Agent
Tap["Homebrew Tap"] --> Distribution
The project intentionally uses independent repositories. Cross-repository integration happens through versioned HTTP, SSE, WebSocket, schema, fixture, and release-manifest contracts rather than shared source imports.
| Repository | Responsibility |
|---|---|
| iphone-app | Native SwiftUI iPhone client |
| mobile-web | React client and same-origin Gateway |
| relay-server | Relay, Run Server, Runtime Auth, and contracts |
| mac-agent | Local Codex execution and workspace adapter |
| admin-platform | Diagnostics server, collector, and admin UI |
| runtime-distribution | Runtime CLI, supervisor, assembly, and release checks |
| homebrew-tap | Homebrew installation and public Runtime releases |
| docs | Product, architecture, protocol, ADR, and release documentation |
brew trust --formula codex-remote/tap/codex-remote
brew install codex-remote/tap/codex-remote
codex-remote setup --workspace-root ~/work
codex-remote pairRead the installation guide and its security limitations before installing.
Start with CONTRIBUTING.md and open changes in the repository that owns the affected component. Report vulnerabilities privately as described in SECURITY.md.
All current source repositories are licensed under the Apache License 2.0. Previously published Beta archives retain the license embedded in those immutable artifacts.
