Bridge Manager

What is Bridge Manager?

bridge-terminal-manager is a daemon that runs on your servers or workstations, allowing you to start Claude Code sessions remotely from your mobile app - without needing to be physically at the machine.

Remote Session Start

Open your phone, tap a machine, and start a Claude session - even when you're miles away from your computer.

Always Running

Runs as a background daemon, automatically reconnects after reboots, and stays ready for session requests.

Secure Authentication

Email verification ensures only you can register machines and start sessions on your account.

Multi-Machine

Register multiple machines and switch between them from the Machines tab in your mobile app.

Installation

macOS / Linux

# Quick install:

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

Windows (PowerShell)

# Run in PowerShell as Administrator:

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

Getting Started

1

Run the Manager

After installation, simply run:

bridge-terminal-manager

2

Register the Machine

On first run, you'll be prompted to:

• Enter your email address
• Enter the verification code sent to your email
• Give your machine a name (e.g., "Office Desktop", "Home Server")

3

Start Sessions from Your Phone

Once registered, the manager runs as a daemon. In your mobile app:

• Go to the Machines tab
• Tap on your registered machine
• Tap Create Session to start Claude remotely

Command Reference

bridge-terminal-manager

Register (if needed) and start the daemon in background

bridge-terminal-manager -f

Run in foreground (useful for debugging)

bridge-terminal-manager -status

Check registration and daemon status

bridge-terminal-manager -stop

Stop the running daemon

bridge-terminal-manager -reset

Clear registration and start fresh

Use Cases

Home Workstation

Left your computer at home? Start a Claude session on it from anywhere and get work done remotely.

Development Server

Run Claude on your dev server to make changes, run tests, or deploy - all from your phone.

Office Computer

Working from home but need to access your office machine? Start Claude sessions remotely.

Cloud VMs

Running a cloud VM? Install the manager and control Claude on it from anywhere.

Frequently Asked Questions

Does the manager need to run as root/admin?

No, the manager runs under your user account. It doesn't require elevated privileges.

What happens after a reboot?

You'll need to run bridge-terminal-manager again after a reboot. For auto-start, you can add it to your system's startup scripts or use a service manager.

How many machines can I register?

There's no limit on the number of machines you can register. All machines appear in the Machines tab of your mobile app.

Is it secure?

Yes. Registration requires email verification. All communication is encrypted. Only authenticated users on your account can start sessions on your machines.

What's the difference between bridge-terminal and bridge-terminal-manager?

bridge-terminal starts a single session and displays a code to connect. bridge-terminal-manager is a daemon that waits for session requests from your phone and spawns bridge-terminal sessions on demand.