bridle
starsforks
How to install bridle?
neiii/bridle
$git clone https://github.com/neiii/bridleUnified configuration manager for AI coding assistants. Manage profiles, install skills/agents/commands, and switch configurations across Claude Code, OpenCode, Goose, Amp, Copilot CLI, and Crush.
README.md
| 1 |  |
| 2 | |
| 3 | # Bridle |
| 4 | |
| 5 | Unified configuration manager for AI coding assistants. Manage profiles, install skills/agents/commands, and switch configurations across Claude Code, OpenCode, Goose, Amp, Copilot CLI, and Crush. |
| 6 | |
| 7 | ## Installation |
| 8 | |
| 9 | ### Try it instantly (no install) |
| 10 | |
| 11 | Run once without installing: |
| 12 | |
| 13 | | Package Manager | Command | |
| 14 | | --------------- | -------------------- | |
| 15 | | npx | `npx bridle-ai` | |
| 16 | | bunx | `bunx bridle-ai` | |
| 17 | | pnpm | `pnpm dlx bridle-ai` | |
| 18 | |
| 19 | ### Install globally |
| 20 | |
| 21 | For repeated use, install once: |
| 22 | |
| 23 | **Node package managers:** |
| 24 | |
| 25 | | Manager | Command | |
| 26 | | ------- | -------------------------- | |
| 27 | | npm | `npm install -g bridle-ai` | |
| 28 | | bun | `bun install -g bridle-ai` | |
| 29 | | pnpm | `pnpm add -g bridle-ai` | |
| 30 | |
| 31 | **Other methods:** |
| 32 | |
| 33 | ```bash |
| 34 | # Homebrew |
| 35 | brew install neiii/bridle/bridle |
| 36 | |
| 37 | # Cargo |
| 38 | cargo install bridle |
| 39 | |
| 40 | # From source |
| 41 | git clone https://github.com/neiii/bridle && cd bridle && cargo install --path . |
| 42 | ``` |
| 43 | |
| 44 | ## Quick Start |
| 45 | |
| 46 | ```bash |
| 47 | # Launch the TUI |
| 48 | bridle |
| 49 | |
| 50 | # See what's configured across all harnesses |
| 51 | bridle status |
| 52 | |
| 53 | # Create a profile from your current config |
| 54 | bridle profile create claude work --from-current |
| 55 | |
| 56 | # Switch between profiles |
| 57 | bridle profile switch claude personal |
| 58 | ``` |
| 59 | |
| 60 |  |
| 61 | |
| 62 | ## "Package Manager" for your harness |
| 63 | |
| 64 | With Bridle, you're able to install skills, agents, commands, and MCPs from any GitHub repository, similar to how Claude Code does it. With Bridle, however, you're not limited to just one harness; we auto-translate all the paths, namings, schemas, and configurations for you. |
| 65 | |
| 66 | ```bash |
| 67 | # Install from GitHub |
| 68 | bridle install owner/repo |
| 69 | |
| 70 | # What happens: |
| 71 | # 1. Bridle scans the repo for skills, agents, commands, and MCPs |
| 72 | # 2. You select which components to install |
| 73 | # 3. You choose target harnesses and profiles |
| 74 | # 4. Bridle translates paths and configs for each harness automatically |
| 75 | ``` |
| 76 | |
| 77 | **Why this matters:** A skill written for Claude Code uses `~/.claude/skills/`. The same skill on OpenCode lives at `~/.config/opencode/skill/`. MCPs follow different JSON/YAML schemas. Bridle handles all these differences for you. |
| 78 | |
| 79 | | Component | Claude Code | OpenCode | Goose | Copilot CLI | Crush | |
| 80 | | --------- | ----------- | -------- | ----- | ----------- | ----- | |
| 81 | | Skills | `~/.claude/skills/` | `~/.config/opencode/skill/` | `~/.config/goose/skills/` | `~/.copilot/skills/` | `~/.config/crush/skills/` | |
| 82 | | Agents | `~/.claude/plugins/*/agents/` | `~/.config/opencode/agent/` | — | `~/.copilot/agents/` | — | |
| 83 | | Commands | `~/.claude/plugins/*/commands/` | `~/.config/opencode/command/` | — | — | — | |
| 84 | | MCPs | `~/.claude/.mcp.json` | `opencode.jsonc` | `config.yaml` | `~/.copilot/mcp-config.json` | `crush.json` | |
| 85 | |
| 86 | ## Core Concepts |
| 87 | |
| 88 | **Harnesses** are AI coding assistants: `claude`, `opencode`, `goose`, `amp`, `copilot`, `crush` |
| 89 | |
| 90 | **Profiles** are saved configurations. Each harness can have multiple profiles (e.g., `work`, `personal`, `minimal`). Bridle copies the active profile's config into the harness's config directory when you switch. |
| 91 | |
| 92 | ## Commands |
| 93 | |
| 94 | ### Status & TUI |
| 95 | |
| 96 | | Command | Description | |
| 97 | | --------------- | ------------------------------------------ | |
| 98 | | `bridle` | Launch interactive TUI | |
| 99 | | `bridle status` | Show active profiles across all harnesses | |
| 100 | | `bridle init` | Initialize bridle config and default profiles | |
| 101 | |
| 102 | ### Profiles |
| 103 | |
| 104 | | Command | Description | |
| 105 | | ------------------------------------------------------- | ------------------------------------------- | |
| 106 | | `bridle profile list <harness>` | List all profiles for a harness | |
| 107 | | `bridle profile show <harness> <name>` | Show profile details (model, MCPs, plugins) | |
| 108 | | `bridle profile create <harness> <name>` | Create em |
People who liked this also viewed
6 picksType
- excel-mcpA Model Context Protocol (MCP) server for working with Excel (.xlsx) files without requiring Microsoft Excel. Enables AI assistants to create, read, modify, and format spreadsheets using openpyxl, fully in Python and cross-platform.MCP ServersOct 2025
- memories-with-lessons-mcp-serverI enhance the existing memory mcp server from the official mcp github, so big thanks and credits for creating thisMCP ServersFeb 2025
- anytype-mcpAn MCP server enabling AI assistants to interact with Anytype - your encrypted, local and collaborative wiki - to organize objects, lists, and more through natural language.MCP ServersJul 2026
- mcp-server-kubernetesMCP Server for kubernetes management commandsMCP ServersJul 2026
- thoughtboxThoughtbox is an intention ledger for agents. Evaluate AI's decisions against its decision-making.MCP ServersJul 2026
- google-drive-mcpA Model Context Protocol (MCP) server that provides secure integration with Google Drive, Docs, Sheets, Slides and Calendar. It allows Claude Desktop and other MCP clients to manage files in Google Drive through a standardized interface.MCP ServersJul 2026
