A mobile client for Codex and Claude that uses a WebSocket bridge to remotely control coding agent sessions from your phone.
CC Pocket is a cross-platform (iOS, Android, macOS) remote control client for coding agents. It deploys a lightweight Bridge Server (Node.js/TypeScript) on the development host and connects the phone to running Claude Code or Codex CLI sessions via WebSocket, turning the phone into a remote console.
Core capabilities include: real-time streaming of agent plans and tool activities, touch-first approval UI with push notifications, syntax-highlighted diff review (including image diffs), Markdown prompt editor, multi-session parallel management with project grouping, automatic Git Worktree isolation, SSH remote host management, mDNS LAN auto-discovery, and QR code quick connect. It supports four Claude permission modes (Default/Accept Edits/Plan/Bypass All) and multiple Codex approval policies, with sandbox configuration for both. The Bridge Server can be registered as a macOS (launchd) or Linux (systemd) background service, and session history is fully compatible with Claude Code.
Installation
Prerequisites: Node.js 18+, host with Codex CLI or Claude Code installed (ANTHROPIC_API_KEY required, not OAuth).
npx @ccpocket/bridge@latest
Clients: iOS (App Store), Android (Google Play), macOS desktop (.dmg from GitHub Releases).
Connection methods: QR code scan, saved machine list, mDNS auto-discovery, manual URL input.
Key Environment Variables
| Variable | Default | Description |
|---|---|---|
BRIDGE_PORT | 8765 | WebSocket port |
BRIDGE_HOST | 0.0.0.0 | Bind address |
BRIDGE_API_KEY | Unset | Enable API key auth |
BRIDGE_ALLOWED_DIRS | $HOME | Allowed project dirs, comma-separated |
BRIDGE_DISABLE_MDNS | Unset | Disable mDNS auto-discovery |
DIFF_IMAGE_AUTO_DISPLAY_KB | 1024 | Image diff auto-display threshold |
DIFF_IMAGE_MAX_SIZE_MB | 5 | Max diff preview image size |
Claude Permission Modes: Default / Accept Edits / Plan / Bypass All
Codex Approval Policies: Untrusted / On Request / On Failure / Never Ask
.gtrconfig (Worktree Config): Located at project root, supports [copy] (include/exclude/includeDirs/excludeDirs) and [hook] (postCreate/preRemove) sections for controlling file copy rules and lifecycle hooks during git worktree creation.
Architecture: Phone App ↔ WebSocket ↔ Bridge Server (host) ↔ Claude Agent SDK / Codex CLI. Repository uses npm workspaces; Bridge Server is TypeScript, mobile app is Flutter (Dart 73.1%), macOS desktop is a separate native app. Firebase config files exist (likely for push notifications) along with .mcp.json.
Notes: CC Pocket does not run any AI models itself, does not replace Claude Code or Codex CLI, and is not affiliated with Anthropic or OpenAI. Windows/WSL support is not yet natively verified. A "Supporter / Purchases" feature exists but pricing details are not detailed in the README.