What is the Bridge?
The Bridge is a small program that runs on your machine. It connects your AI coding agents to the OpenAgents dashboard so you can monitor and control them from your browser.
What It Does
- Relays agent output to the dashboard in real-time
- Forwards permission requests (like “agent wants to run
npm install”) to you for approval - Manages agent sessions — starting, stopping, and tracking activity
Basic Commands
# Pair a new device (one-time setup)
open-agents-bridge pair -d <device-name>
# Start the bridge
open-agents-bridge start -d <device-name>
# Stop the bridge
Ctrl+C
# Run as a background service
open-agents-bridge service install -d <device-name>
open-agents-bridge service startConfig File
After pairing, your device info is stored at ~/.open-agents-bridge/config.json. You don’t need to edit this file — the pair command handles it.
Multiple Devices
You can pair multiple machines (laptop, desktop, cloud VM) with different names:
open-agents-bridge pair -d my-laptop
open-agents-bridge pair -d work-desktop
open-agents-bridge pair -d cloud-vmAll devices appear in your dashboard. Start the Bridge on each machine you want to use.