Abridge (Agent Bridge) 🌉

中文版

Abridge (short for Agent Bridge) is a unified configuration management platform designed for developers using multiple Coding Agents. It acts as a bridge between various terminal-based AI agents (such as Claude Code, Codex, Gemini CLI, etc.), allowing you to centrally manage all your MCP (Model Context Protocol) server configurations, skills, and session records.

🌟 Key Features

• Bidirectional Sync: Effortlessly distribute configurations to multiple tools, and pull/merge existing configurations from tools back into Abridge.
• Unified MCP Management: Support for Stdio, HTTP, Local, and Remote MCP protocols. Configure once, use everywhere.
• Tool Adapters:
  • ✅ Claude Code (Supports the latest .claude.json monolithic format)
  • ✅ Codex (Supports .codex/config.toml format)
  • ✅ OpenCode (Supports ~/.config/opencode/opencode.json format)
  • ✅ Crush (Supports ~/.config/crush/config.json format)
  • ✅ Antigravity (Supports ~/.gemini/antigravity/mcp_config.json format)
  • ✅ Gemini CLI (Supports ~/.gemini/settings.json format)
  • 🏗️ Cursor (Coming soon)
• High-Performance Runtime: Built with Bun for blazing-fast response times.
• TUI Workspace Manager: A centralized dashboard to manage multiple running agents using abridge ui. Monitor logs, switch focus, and keep agents running in the background. (Experimental)
• Launch Command: Rapidly start AI coding tools via abridge launch or the TUI dashboard. Includes interactive selection and tool detection.
• Local-First: All configurations and data are stored locally on your machine, ensuring maximum privacy.

🚀 Quick Start

Installation

One-Line Install (Recommended)

curl -fsSL https://raw.githubusercontent.com/Tomyail/abridge/main/install.sh | bash

From GitHub Releases

Download the pre-compiled binary for your platform from the Releases page:

• abridge-macos-arm64 (Apple Silicon)
• abridge-macos-x64 (Intel Mac)
• abridge-linux-x64
• abridge-linux-arm64

After downloading, move it to your bin folder and make it executable:

chmod +x abridge-*
sudo mv abridge-* /usr/local/bin/abridge

From NPM

npm install -g abridge

From Source

git clone https://github.com/Tomyail/abridge.git
cd abridge
bun install

Usage Guide

1. Initialize: Create the default configuration file at ~/.abridge/config.yaml

   abridge init

2. Import Configuration: Pull your existing MCP servers from installed tools.

   abridge import

3. Edit Configuration: Modify your MCP servers in ~/.abridge/config.yaml.

4. Apply Configuration: Synchronize the unified configuration back to all supported tools.

   abridge apply

5. Workspace UI: Start the TUI dashboard to launch and manage agents.

   abridge ui # Starts the dashboard
   # Press 't' to launch a new agent (Claude, Crush, etc.)
   # Use keys [1-9] to switch between active sessions.
   # Press Ctrl+q or Ctrl+a to detach and return to the menu.

📂 Project Structure

This project uses a Monorepo architecture:

• packages/cli: Command-line interface and TUI implementation.
• packages/core: Core logic, adapter system, process management.
• packages/sdk: SDK for integration with other tools.

🗺️ Roadmap

• Unified config parsing (YAML)
• Claude Code Adapter (Bidirectional)
• Codex Adapter (Bidirectional)
• OpenCode Adapter (Bidirectional)
• Crush Adapter (Launch Support)
• Configuration merging logic
• Unified support for HTTP Headers and Remote MCP
• GitHub CI/CD automation for cross-platform distribution
• Interactive /launch command
• Phase 2: TUI Workspace Manager (Process Supervisor, Dashboard)
• Secret Masking (Encrypted storage for API keys/tokens)
• Unified session history collection and search
• Multi-device sync (via iCloud/Dropbox)

📄 License

MIT