Open source · Craftstead
Your desktop agents,
from a browser.
Agent Bridge is a Mac-side bridge to the AI agents you already run. Check a session, send the next instruction, or forward a message to another client on the same Mac — from a phone or another computer. It is free and open source, built by Craftstead.
Pair a device
A one-time invite, a six-digit code.
On the Mac, run agent-bridge invite, or choose “Invite new device” in the menu bar. It prints a link and a six-digit code. Open the link on the device you want to pair, or paste it here.
Opened the client first? Paste the link on its own pairing screen.
Open the client homeHow it works
From a closed laptop to a live session.
Four steps, one of them a code you compare by eye. The bridge does the connecting; you keep the Mac and the browser on the same page.
-
Run Agent Bridge on the Mac
Install and start the bridge — the CLI, the menu bar app, or both. It discovers local sessions and dials out to a Cloudflare relay, so there is no public IP or port forward to arrange.
-
Mint one invite
Invites are single-use and expire after five minutes by default. Open the link on the other device, or paste it into the client’s pairing screen.
-
Compare the six-digit code
The Mac and the browser show the same code. If they match, confirm and the device is granted access. If they differ, cancel.
-
Work in an existing session
Browse projects and sessions, continue one where the adapter allows it, and optionally preview or edit a message before sending it to another agent.
Supported agents
What it can reach, and what it cannot.
The host is a Mac. Mirrored adapters list and read the sessions a desktop or CLI app already has; they do not create new sessions. Sessions the bridge hosts itself can be created from the browser.
| Source | What you can do | Limits |
|---|---|---|
| Claude Code · Bridge-hosted Hosted by Agent Bridge | List, read, send and create sessions from the browser; approvals work end to end. | Hosted sessions do not appear in the desktop app. |
| pi · Bridge-hosted Hosted by Agent Bridge | List, read, send and create sessions from the browser. | Hosted sessions do not appear in the desktop app. |
| Claude Desktop · Code Claude Code in the desktop app | List, read, and send in existing Code sessions. | Not Claude Chat or Cowork. Send uses an unofficial local channel. |
| ChatGPT Desktop · Codex Codex threads | List and read Codex threads; send only if that thread is already open in the desktop app. | Not native ChatGPT Chat or Work. |
| Antigravity CLI Command line | List, read, and send in existing CLI sessions. | Cannot create a session from the bridge. |
| Antigravity Desktop Desktop app | List and read while the desktop app is running. | Send is not supported. |
| DeepSeek Harness dsh | List, read, and send by resuming with dsh --profile headless. | Cannot create a session. Send is refused if the desktop app already has that session open. |
Adapters use unofficial local channels and may break when a vendor app updates. When one does, the bridge reports the failure instead of pretending the session is available.
Security
The relay moves ciphertext.
Pairing and reconnects are end-to-end encrypted between the browser and the Mac. The hosted relay is a forwarding path, not a reader.
- Handshake
- Browser and Mac complete a Noise XX handshake, with the invite as a pre-shared key, to pair; reconnects use Noise IK. The Cloudflare Worker forwards ciphertext, and should not see chat bodies, project names, or model API keys.
- Network
- The Mac opens an outbound WebSocket. No inbound ports, no port forwarding, no public address.
- Invites
- Single-use and short-lived. Devices can be expired or revoked from the Mac menu bar or CLI.
- Optional power
- Remote file browsing and command execution are off until you turn them on, and file access is scoped to the session’s project directory.
- Limits
- This is not a formal security audit. The web frontend is a trusted endpoint: it decrypts what it displays.
Self-host
Use the hosted relay, or run your own.
The relay is a Cloudflare Worker with Durable Object rooms and the web assets. Deploy it yourself with Wrangler, then point the Mac bridge at your origin.
You can use the hosted relay at agent-bridge.craftstead.app or deploy the Worker yourself. Setup details live in the GitHub README. A light personal deployment can often stay on Cloudflare’s free tier; that is not a guarantee, and model bills stay with the vendor.
agent-bridge init --relay https://your-relay.example
agent-bridge up The bridge, relay and web client are one repository, so a self-hosted relay pairs with a client you serve from the same origin.
FAQ
Short answers.
Is it free?
Yes. Agent Bridge is open source with no product paywall. You still pay your model vendors for the models you use.
Does it run on Windows or Linux?
Not today. The host side is macOS only.
Can it reach Claude Chat or Cowork, or ChatGPT Chat or Work?
No. The adapters cover Claude Desktop Code, ChatGPT Desktop Codex, Antigravity CLI and Desktop, and DeepSeek Harness.
Do I need a public IP or an open port?
No. The Mac dials out to the relay over an outbound WebSocket, so there is nothing to forward on your router.
What languages does the interface speak?
Eight: 中文, English, 日本語, 한국어, Español, Français, Deutsch and Português — in both the web client and the menu bar app. The web client starts in your browser's language and can be switched from the menu at the top; the menu bar app can follow your system language instead. Dates and times follow the language you pick.
Can I start a brand-new session from the phone?
Yes — for sessions the bridge hosts itself. Hosted Claude Code and pi sessions can be created from the browser, approvals included. Sessions mirrored from a desktop or CLI app still have to be started in that app first; the bridge continues what already exists there.
Is there a QR code for pairing?
Not yet. You copy or paste the invite link, or open it directly on the other device.
Open source
Read it, run it, change it.
Agent Bridge is free and open source. The bridge, the relay and the web client live in one repository; issues and pull requests are welcome.
Built by Craftstead. Bookmark agent-bridge.craftstead.app or add it to your home screen to skip this page next time.