Claude Bridge

Mirror and control your Claude Code sessions from your phone. No cloud, no middlemen: the phone talks directly to your PC — over your LAN, or through a P2P tunnel when you're away.

What it is

Claude Bridge runs a lightweight Node.js bridge on your computer that mirrors Claude Code terminal sessions to an Android app. From your phone, you see the same terminal as on the PC, type text and commands, switch sessions, answer permission prompts — and get push notifications when Claude is waiting for you or has finished.

All communication is direct between your own devices. On Wi-Fi, it's your LAN; away from home, it's an encrypted P2P tunnel (iroh/QUIC) with no relay servers in between. Traffic is protected by TLS with certificate pinning; access is granted via one-time pairing.

Features

- 📱 Full terminal on the phone — xterm.js in a WebView: input, arrows, Esc/Tab/Ctrl-C, touch scroll & selection, clipboard paste. - 🔀 Multiple sessions — tabs, switching, new sessions (--resume, --dangerously-skip-permissions), multiple paired PCs. - 🔔 Push notifications from hooks — "Claude is waiting", "Claude finished", with quick-reply buttons from the notification shade. - 🌐 Works away from home — if the PC isn't visible on Wi-Fi, a P2P tunnel (iroh) is brought up automatically; LAN is always preferred. - 🎙️ Voice input — dictate messages (faster-whisper on the PC), optional. - 🔒 Privacy & security — self-signed TLS + fingerprint pinning, QR/code pairing, biometric app lock, FLAG_SECURE, tokens only on trusted devices. - 💾 Sessions survive everything — keeper processes own the PTYs independently of the bridge: restarting the bridge or closing the app doesn't kill Claude's work.

How it works (short)

1. The phone discovers the PC on the network (mDNS/UDP) and connects. 2. Terminal I/O flows both ways over a WebSocket on top of TLS. 3. Claude Code hooks turn into push notifications on the phone.

License

© Black Triangle

GNU General Public License v3.0