Documentation

Quick Start

1. Install the Mobile App

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

2. Install bridge-terminal on your computer/server

# macOS / Linux

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

3. Start a session

bridge-terminal

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

Installation

macOS / Linux

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

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

Windows (PowerShell)

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

Run PowerShell as Administrator for system-wide installation.

Usage

Basic Usage

bridge-terminal

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 bridge-terminal as a background service:

# Using nohup

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

# Using systemd (Linux)

sudo systemctl enable bridge-terminal

sudo systemctl start bridge-terminal

Mobile App

Connecting to a Session

Open the Bridge Terminal 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 bridge-terminal
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)

Bridge Manager

Want to start Claude sessions remotely from your phone without manually running bridge-terminal? The Bridge Manager daemon runs in the background and lets you start sessions on any registered machine.

Bridge Manager Documentation