@ccpocket/bridge
v1.10.1
Published
Bridge server that connects Claude Code and Codex CLI to mobile devices via WebSocket
Maintainers
Readme
@ccpocket/bridge
Bridge server that connects Claude Code CLI and Codex CLI to mobile devices via WebSocket.
This is the server component of ccpocket — a mobile client for Claude Code and Codex.
Quick Start
npx @ccpocket/bridge@latestA QR code will appear in your terminal. Scan it with the ccpocket mobile app to connect.
Installation
# Run directly (no install needed)
npx @ccpocket/bridge@latest
# Or install globally
npm install -g @ccpocket/bridge
ccpocket-bridgeConfiguration
| Environment Variable | Default | Description |
|---------------------|---------|-------------|
| BRIDGE_PORT | 8765 | WebSocket port |
| BRIDGE_HOST | 0.0.0.0 | Bind address |
| BRIDGE_API_KEY | (none) | API key authentication (enabled when set) |
| BRIDGE_DEMO_MODE | (none) | Demo mode: hide Tailscale IPs and API key from QR code / logs |
# Example: custom port with API key
BRIDGE_PORT=9000 BRIDGE_API_KEY=my-secret npx @ccpocket/bridge@latestRequirements
- Node.js v18+
- Claude Code CLI and/or Codex CLI
Health Check
Run the built-in doctor command to verify your environment:
npx @ccpocket/bridge@latest doctorIt checks Node.js, Git, CLI providers, macOS permissions (Screen Recording, Keychain), network connectivity, and more.
Architecture
Mobile App ←WebSocket→ Bridge Server ←stdio→ Claude Code CLIThe bridge server spawns and manages Claude Code CLI processes, translating WebSocket messages to/from the CLI's stdio interface. It supports multiple concurrent sessions.
