Zane lets you monitor and control Codex CLI sessions running on your Mac from your phone, tablet, or any browser. Start tasks, watch real-time output, approve file writes, and review diffs from a handheld web client while your agent runs locally.
- Start tasks remotely -- kick off Codex sessions from your phone
- Live streaming -- watch agent output, reasoning, and diffs in real-time
- Approve or deny -- handle permission prompts from anywhere
- Review diffs -- inspect code changes per turn before they land
- Plan mode -- review and approve plans before the agent writes code
- Push notifications -- get notified on your phone for approvals and important session events
- No port forwarding -- Anchor connects outbound to Cloudflare; no open ports on your Mac
- Passkey auth -- WebAuthn passkeys, no passwords
- Self-host first -- run Orbit and Pages in your own Cloudflare account
Phone / Browser
|
| HTTPS + WebSocket
↓
Orbit (Cloudflare Workers)
↑
| WebSocket
↓
Anchor (local daemon)
|
| JSON-RPC over stdio
↓
Codex app-server
Anchor is a lightweight daemon on your Mac that spawns codex app-server and relays structured JSON-RPC messages. Orbit is a Cloudflare Worker + Durable Object that handles passkey auth, push notification fan-out, and WebSocket relay between your devices and Anchor. The web client is a static Svelte app on Cloudflare Pages.
curl -fsSL https://raw.githubusercontent.com/cospec-ai/zane/main/install.sh | bashThe installer now prompts whether to run self-host deployment immediately or skip and run it later.
zane startIf you skipped deployment during install, run:
zane self-host
zane startOn first run:
- A device code appears in your terminal.
- A browser window opens for authentication.
- You sign in with your passkey.
- Anchor connects to Orbit and is ready for commands from the web client.
This path deploys and uses your own Cloudflare account, and is the current generally available setup. Managed Orbit access is currently waitlist-only.
| Command | Description |
|---|---|
zane start |
Start the Anchor service |
zane login |
Re-authenticate |
zane doctor |
Check prerequisites and configuration |
zane config |
Open .env in your editor |
zane update |
Pull latest and reinstall |
zane self-host |
Deploy to your own Cloudflare account |
zane uninstall |
Remove Zane |
| Doc | Description |
|---|---|
| Installation | Detailed install and setup guide |
| Self-Hosting | Deploy to your own Cloudflare account |
| Architecture | System design, components, and data flows |
| Auth | Passkey authentication and JWT details |
| Events | JSON-RPC protocol reference |
| Security | Threat model and security controls |
| Repo Structure | Project directory layout |
| Vision | Product vision and design principles |
Contributions are welcome. Please open an issue first to discuss what you'd like to change.