Package Exports

@ccpocket/bridge
@ccpocket/bridge/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@ccpocket/bridge) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

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@latest

A 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-bridge

Configuration

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@latest

Requirements

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 doctor

It checks Node.js, Git, CLI providers, macOS permissions (Screen Recording, Keychain), network connectivity, and more.

Architecture

Mobile App ←WebSocket→ Bridge Server ←stdio→ Claude Code CLI

The bridge server spawns and manages Claude Code CLI processes, translating WebSocket messages to/from the CLI's stdio interface. It supports multiple concurrent sessions.

License

MIT