MCPgee
MCPgee
MCPgeeMCPgee

Bridle

v1.0.0•Developer Tools•stable

TUI / CLI config manager for agentic harnesses (Amp, Claude Code, Opencode, Goose, Copilot CLI, Crush, Droid)

aiampcodeclaude-codecliconfiguration
Share:
426
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Bridle?

Bridle is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to tui / cli config manager for agentic harnesses (amp, claude code, opencode, goose, copilot cli, crush, droid)

TUI / CLI config manager for agentic harnesses (Amp, Claude Code, Opencode, Goose, Copilot CLI, Crush, Droid)

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • TUI / CLI config manager for agentic harnesses (Amp, Claude

Use Cases

Agentic harness configuration
TUI/CLI config manager
Multi-agent tool integration
neiii

Maintainer

LicenseMIT
Languagerust
Versionv1.0.0
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx bridle

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Bridle

Bridle is a TUI and CLI configuration manager for AI coding agent harnesses — Claude Code, OpenCode, Goose, Amp, Copilot CLI, and Crush — that lets you create named profiles, switch between them instantly, and manage skills, agent definitions, commands, and MCP server lists across all supported tools from a single interface. It handles the path and schema translation between platforms automatically, so the same MCP configuration works regardless of which coding assistant you switch to. Developers who use multiple AI coding agents or who maintain separate work and personal setups use it to avoid manually editing each tool's config files.

Prerequisites

  • Node.js with npm, Bun, or pnpm installed — OR — Rust/Cargo installed — OR — Homebrew (macOS) for package installation
  • At least one supported AI coding agent harness installed: Claude Code, OpenCode, Goose, Amp, Copilot CLI, or Crush
  • A terminal that supports TUI rendering (most modern terminals are supported)
1

Install Bridle

Install via your preferred package manager. npm, bun, pnpm, Homebrew, and Cargo are all supported.

# npm (global):
npm install -g bridle-ai

# Homebrew:
brew install neiii/bridle/bridle

# Cargo:
cargo install bridle

# No-install run:
npx bridle-ai
2

Initialise Bridle

Run 'bridle init' to create the configuration file at ~/.config/bridle/config.toml and detect installed harnesses.

bridle init
3

Launch the TUI

Run 'bridle' with no arguments to open the interactive TUI. From here you can browse profiles, switch active configurations, and manage skills and MCPs for each harness.

bridle
4

Create a named profile

Create a new profile for a specific harness and use-case (e.g., a 'work' profile for Claude Code with work-specific MCP servers).

bridle profile create claude work
5

Switch between profiles

Switch the active profile for a harness. Bridle writes the updated configuration to the harness's native config location.

bridle profile switch claude work
6

Install a community skill or MCP from GitHub

Install a skill or MCP definition from a GitHub repository directly into Bridle's library.

bridle install owner/repo-name

Bridle Examples

Client configuration

Bridle itself manages harness configs rather than acting as an MCP server. To run it as an MCP tool from Claude Desktop, use the bridle-ai package.

{
  "mcpServers": {
    "bridle": {
      "command": "npx",
      "args": ["bridle-ai"]
    }
  }
}

Prompts to try

CLI commands representing typical Bridle usage across profile management and harness configuration.

- "bridle status  # Show which profile is active for each harness"
- "bridle profile list claude  # List all Claude Code profiles"
- "bridle profile create opencode personal  # Create a 'personal' profile for OpenCode"
- "bridle profile switch claude work  # Switch Claude Code to the 'work' profile"
- "bridle install neiii/example-mcp-skill  # Install an MCP skill from GitHub"

Troubleshooting Bridle

Bridle does not detect an installed harness

Confirm the harness CLI is on your PATH and accessible from the same shell where you run Bridle. For example, run 'claude --version' or 'opencode --version'. Then re-run 'bridle init' to re-scan for installed tools.

Profile switch does not take effect in the running harness

Bridle writes to the harness's config file on disk. You need to restart the affected harness (e.g., close and reopen Claude Code) for it to pick up the new profile. Some harnesses may require a full terminal restart.

'bridle-ai' not found when running via npx

Ensure you are using the package name 'bridle-ai' (with a hyphen), not 'bridle'. The npm package is published as bridle-ai. Run 'npx bridle-ai --version' to confirm the package resolves correctly.

Frequently Asked Questions about Bridle

What is Bridle?

Bridle is a Model Context Protocol (MCP) server that tui / cli config manager for agentic harnesses (amp, claude code, opencode, goose, copilot cli, crush, droid) It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Bridle?

Follow the installation instructions on the Bridle GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Bridle?

Bridle works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Bridle free to use?

Yes, Bridle is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Bridle Alternatives — Similar Developer Tools Servers

Looking for alternatives to Bridle? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.

Ecc

★ 188.2k

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Javaguide

★ 155.8k

Java 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发

Gemini CLI

★ 104.5k

A secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in

Awesome MCP Servers

★ 87.3k

⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.

MCP Servers

★ 86.0k

Model Context Protocol Servers

CC Switch

★ 77.5k

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Developer ToolsBrowse All Servers

Quick Config Preview

{ "mcpServers": { "bridle": { "command": "npx", "args": ["-y", "bridle"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Bridle?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides