JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 1038
  • Score
    100M100P100Q111094F
  • License MIT

Bridge server that connects Claude Code and Codex CLI to mobile devices via WebSocket

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

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