@agentbridge10/cli

Install and manage AgentBridge MCP servers across MCP hosts.

Quick reference

agentbridge install --site 1mg              # autodetect installed hosts and wire them up
agentbridge install --site 1mg --print-only # dry-run; print the merged config to stdout
agentbridge uninstall --site 1mg            # remove from all detected hosts
agentbridge doctor                          # diagnose: hosts, build artifacts, flows, Chrome
agentbridge list-sites                      # show registered site bundles

Supported hosts

| ID | Display name | Config file | |---|---|---| | antigravity | Antigravity | ~/.gemini/antigravity/mcp_config.json | | claude-desktop | Claude Desktop | macOS ~/Library/Application Support/Claude/claude_desktop_config.json; Windows %APPDATA%/Claude/claude_desktop_config.json | | claude-code | Claude Code | ~/.claude.json | | cursor | Cursor | ~/.cursor/mcp.json | | windsurf | Windsurf | ~/.codeium/windsurf/mcp_config.json | | chatgpt-desktop | ChatGPT Desktop | macOS ~/Library/Application Support/ChatGPT/mcp_config.json; Windows %APPDATA%/ChatGPT/mcp_config.json | | gemini-cli | Gemini CLI | ~/.gemini/settings.json |

Every install backs the prior config up to <file>.bak-YYYYMMDD-HHmmss before writing.

What install does, in detail

1. Look up the site in the registry (src/sites/registry.ts).
2. Resolve flow file paths against the repo root and verify each exists.
3. Verify the MCP server build artifact exists (packages/mcp-server/dist/index.js).
4. For each target host:
   • Read existing config (preserve all unknown keys).
   • Insert/replace mcpServers["agentbridge-<slug>"] with {command: "node", args: [...]}.
   • Back up prior file, atomic-rename new file into place.
5. Print "Restart <host> to load." per host.

Adding a new host

Drop a new file in src/hosts/ exporting a HostAdapter, then register it in src/hosts/index.ts. The adapter only needs four methods (configPath, isInstalled, install, uninstall); the rest is shared.

Adding a new site

Append to the SITES array in src/sites/registry.ts. No code changes elsewhere.