🌉 Bridge — Talk to Claude from your phone

A mobile chat interface for Claude with full terminal access to your Mac.

Bridge turns your phone into a remote command center. Send messages, run terminal commands, edit files, restart services — all through a beautiful mobile-first chat UI powered by Claude.

Why Bridge?

• Claude on your phone with full Mac access — not just chat, actual terminal commands
• Two modes: Tools (Claude Code with bash/file/grep) and Claude.ai (memory + project knowledge)
• Streaming responses — see Claude thinking in real-time, word by word
• Runs on your Max plan — no API charges
• Survives reboots — LaunchAgent with auto-restart
• Apple-quality UI — dark theme, iOS-optimized, add to Home Screen
• Secure — passphrase-protected, Tailscale encrypted tunnel

How It Works

Phone → Tailscale → Bridge Server → Claude Code CLI → Your Mac

Bridge is a lightweight Node.js server (~200 lines) that:

1. Serves a mobile-first chat UI
2. Proxies messages to Claude Code CLI on your Mac
3. Streams responses back to your phone
4. Includes a Chrome extension relay for Claude.ai conversations with memory

Features

• Terminal access — Run any bash command on your Mac remotely
• File operations — Read, write, edit, search files
• Streaming — Real-time response streaming (no "thinking..." for 60 seconds)
• Conversation persistence — Chat survives closing the tab (localStorage)
• Image support — Send photos from your phone to Claude
• Orion health monitor — Green/red dot shows your OpenClaw agent status
• Copy & Share — Copy messages or share entire conversations
• Quick actions — One-tap buttons for common tasks
• Chrome extension — Relay for Claude.ai with full memory and project knowledge
• Personalized greeting — Time-aware welcome screen

Quick Start

Prerequisites

• macOS with Node.js installed
• Claude Code CLI — npm install -g @anthropic-ai/claude-code && claude auth login
• Tailscale — for secure phone access
• Claude Max plan — so Claude Code runs free

Install (2 minutes)

git clone https://github.com/jonsieling/bridge.git
cd bridge
bash install.sh

The installer asks for a passphrase and sets everything up — LaunchAgent, auto-restart, the works.

Expose to your phone

tailscale funnel --bg --set-path /bridge 7777

Open on your phone

https://your-machine.ts.net/bridge/

Add to Home Screen for an app-like experience.

Claude.ai Mode (Optional)

Want the real Claude.ai with your memory and project knowledge from your phone? Install the included Chrome extension:

1. Open chrome://extensions/
2. Enable Developer mode
3. Click Load unpacked → select chrome-extension/ folder
4. Keep any Claude.ai tab open in Chrome

Now tap "Claude" in Bridge to switch modes.

Architecture

┌─────────────┐     ┌──────────────┐     ┌──────────────────┐
│  Your Phone  │────▶│ Bridge Server │────▶│ Claude Code CLI   │
│  (Safari)    │◀────│ (port 7777)   │◀────│ (claude-max-proxy) │
└─────────────┘     └──────────────┘     └──────────────────┘
       │                    │
       │              Tailscale Funnel
       │              (encrypted HTTPS)
       │
       └─── Add to Home Screen = native app feel

Customization

System Prompt

Edit ~/.bridge/system-prompt.md to change what Claude knows about you:

You are Bridge — Jonathan's remote interface to his Mac.
## My Setup
- OpenClaw runs on this machine
- Key agents: Orion (coordinator), Tom (trading)
## Common Tasks
- Restart OpenClaw: launchctl kickstart -k gui/$(id -u)/ai.openclaw.gateway

Bridge can edit itself

In Tools mode, ask Claude to modify ~/.bridge/index.html or ~/.bridge/server.js. Then reload.

FAQ

Is this free? Yes — if you have a Claude Max plan. Bridge proxies through Claude Code CLI which is included in Max.

Is it secure? Bridge is passphrase-protected and runs over Tailscale (encrypted WireGuard tunnel). Your Mac is never directly exposed.

Does it work when Claude.ai is down? Tools mode works as long as the Anthropic API is up (which is separate from claude.ai). Claude mode requires claude.ai.

Can I use this without Tailscale? You can use it on your local network (http://your-mac-ip:7777), but Tailscale is recommended for access from anywhere.

Does it survive reboots? Yes — Bridge runs as a macOS LaunchAgent with KeepAlive: true.

Built With

• Node.js (zero dependencies)
• Claude Code CLI
• Tailscale Funnel
• Vanilla HTML/CSS/JS (no frameworks)

License

MIT

Credits

Built by Jonathan Sieling and Claude in a late-night hacking session. The entire project — server, UI, Chrome extension, installer — was designed and coded in a single conversation.

---

Star this repo if you want Claude on your phone with real power. 🌉