Documentation

Quick Start

1. Install the Mobile App

Download Claude Bridge from Google Play (iOS coming soon).

2. Install claude-bridge on your computer/server

# macOS / Linux

curl -fsSL https://claude-bridge.com/install.sh | sh

3. Start a session

claude-bridge

A QR code will appear. Scan it with the mobile app to connect.

Installation

macOS / Linux

curl -fsSL https://claude-bridge.com/install.sh | sh

This installs claude-bridge to ~/.claude-bridge/bin/ and adds it to your PATH.

Windows (PowerShell)

irm https://claude-bridge.com/install.ps1 | iex

Run PowerShell as Administrator for system-wide installation.

Manual Download

Download the binary for your platform from the Download page.

macOS Apple Silicon (M1/M2/M3): claude-bridge-darwin-arm64
macOS Intel: claude-bridge-darwin-amd64
Linux x64: claude-bridge-linux-amd64
Linux ARM64: claude-bridge-linux-arm64
Windows x64: claude-bridge-windows-amd64.exe

Usage

Basic Usage

claude-bridge

Starts a new session and displays a QR code for mobile connection.

Command Line Options

--help Show help message

--version Show version number

--verbose Enable verbose logging

--no-qr Don't display QR code

--port PORT Specify local port (default: auto)

Running as a Background Service (Daemon)

For servers, you can run claude-bridge as a background service:

# Using nohup

nohup claude-bridge > /var/log/claude-bridge.log 2>&1 &

# Using systemd (Linux)

sudo systemctl enable claude-bridge

sudo systemctl start claude-bridge

Mobile App

Connecting to a Session

Open the Claude Bridge app on your phone
Tap "Scan QR Code" or enter the session code manually
You'll be connected to the terminal session instantly

Features

Real-time terminal output streaming
Send text input to Claude Code
Push notifications when Claude needs input
Manage multiple sessions
Activity alerts for any terminal output

Troubleshooting

Connection fails or times out

Check your internet connection on both devices
Try restarting claude-bridge
Ensure no firewall is blocking outbound WebSocket connections
Use --verbose flag for more debugging info

QR code won't scan

Ensure good lighting and steady camera
Try increasing terminal font size
Use manual code entry instead (code is shown below QR)

Session disconnects frequently

Check your network stability
Auto-reconnect is enabled by default
Free tier sessions have time limits (upgrade for unlimited)