Usage

View as Markdown Edit on GitHub Docs at 1675df8

Once you're up and running, these guides will help you unlock Termbridge's full potential.

Mobile Controls

On-screen buttons and tips for phone/tablet use

Multiple Terminals

Run several sessions and switch between them

Dev Server Preview

Preview your Vite app alongside the terminal

Named Tunnels

Use your own Cloudflare tunnel to avoid rate limits

AI Coding Tools

Monitor Claude Code, Codex, and other agents remotely

Quick tips

Landscape mode: Rotate your phone for more screen space with TUIs
tmux commands work: Ctrl+B shortcuts function as normal
Auto-reconnect: If you lose connection, just refresh the page
Session persistence: tmux sessions survive Termbridge restarts (unless you use --kill-on-exit)

Limitations

One link per run: Each start issues a single-use share link, so one browser connects per link
Shared terminals: Everyone connected to the same terminal sees the same output and can type
Tunnel required: Without a tunnel (or sandbox direct mode), you need your own public URL
Cloudflare only: Currently the only tunnel provider (or use --no-tunnel / sandbox direct mode)