open-agents-bridge

README

OpenAgents Bridge

中文

Local Bridge CLI that connects AI coding tools with the OpenAgents cloud platform.

Features

• Connect AI CLIs: Claude Code, Gemini CLI, Goose, Cline, Codex
• Real-time WebSocket communication
• End-to-end encryption
• Permission request forwarding
• Multi-session management
• Multi-device support — run multiple bridge instances on one machine
• I/O logging — record user input and AI responses for debugging
• Cross-platform: Windows, Linux, macOS

Install

npm i -g @binoctal/open-agents-bridge

Build from source

make build

Install to system

make install

Quick Start

Pair a device

# Interactive pairing
open-agents-bridge pair

# With device name
open-agents-bridge pair --name work-pc

Start the bridge

# Start a device
open-agents-bridge start --device work-pc

# With debug logging
open-agents-bridge start --device work-pc --log-level debug

Manage devices

# List all devices
open-agents-bridge devices

# View device details
open-agents-bridge device work-pc

System service

open-agents-bridge service install   # Install as system service
open-agents-bridge service start     # Start service
open-agents-bridge service stop      # Stop service
open-agents-bridge service uninstall # Uninstall service

Configuration

Config files are stored in ~/.open-agents-bridge/:

~/.open-agents-bridge/
├── config.json           # Global config
├── devices/              # Device configs
│   ├── work-pc.json
│   └── laptop.json
├── logs/                 # Log files
└── sessions/             # Session data

Global config example

{
  "serverUrl": "wss://api.openagents.top",
  "logLevel": "info",
  "cliEnabled": {
    "claude": true,
    "cline": true,
    "codex": true,
    "gemini": true,
  }
}

Supported CLI Tools

CLI	Status
Claude Code	Supported
Gemini CLI	Supported
Goose	Supported
Cline	Supported
Codex	Supported

Development

make deps      # Download dependencies
make build     # Build binary
make test      # Run tests
make build-all # Build for all platforms

License

GNU Affero General Public License v3.0 (AGPL-3.0). See LICENSE.