bridle

# Bridle Skill Unified configuration manager for AI coding assistants. Manage profiles, install skills/agents/commands, and switch configurations across Claude Code, OpenCode, Goose, and Amp. ## Installation ```bash # Homebrew (macOS/Linux) brew install neiii/bridle/bridle # Cargo (Rust) cargo install bridle # From source git clone https://github.com/neiii/bridle && cd bridle && cargo install --path . ``` ## Core Concepts - **Harnesses**: AI coding assistants (`claude`, `opencode`, `goose`, `amp`) - **Profiles**: Saved configurations per harness (e.g., `work`, `personal`, `minimal`) ## Quick Commands ```bash # Launch interactive TUI bridle # Show active profiles across all harnesses bridle status # Initialize bridle config and default profiles bridle init ``` ## Profile Management ```bash # List all profiles for a harness bridle profile list <harness> # Show profile details (model, MCPs, plugins) bridle profile show <harness> <name> # Create empty profile bridle profile create <harness> <name> # Create profile from current config bridle profile create <harness> <name> --from-current # Switch/activate a profile bridle profile switch <harness> <name> # Open profile in editor bridle profile edit <harness> <name> # Compare profiles bridle profile diff <harness> <name> [other] # Delete a profile bridle profile delete <harness> <name> ``` ## Installing Components Bridle can install skills, agents, commands, and MCPs from GitHub repos and auto-translates paths/configs for each harness. ```bash # Install from GitHub (owner/repo or full URL) bridle install owner/repo # Overwrite existing installations bridle install owner/repo --force # Interactively remove components [experimental] bridle uninstall <harness> <profile> ``` ## Configuration Config location: `~/.config/bridle/config.toml` ```bash # Get a config value bridle config get <key> # Set a config value bridle config set <key> <value> ``` **Config keys:** `profile_marker`, `editor`, `tui.view`, `default_harness` ## Output Formats All commands support `-o, --output <format>`: - `text` (default) — Human-readable - `json` — Machine-readable - `auto` — Text for TTY, JSON for pipes ## Supported Harnesses & Config Locations | Harness | Config Location | Status | | ----------- | ----------------------- | ------------ | | Claude Code | `~/.claude/` | Full support | | OpenCode | `~/.config/opencode/` | Full support | | Goose | `~/.config/goose/` | Full support | | Amp | `~/.amp/` | Experimental | ## Component Paths by Harness | Component | Claude Code | OpenCode | Goose | | --------- | ----------- | -------- | ----- | | Skills | `~/.claude/skills/` | `~/.config/opencode/skill/` | `~/.config/goose/skills/` | | Agents | `~/.claude/plugins/*/agents/` | `~/.config/opencode/agent/` | — | | Commands | `~/.claude/plugins/*/commands/` | `~/.config/opencode/command/` | — | | MCPs | `~/.claude/.mcp.json` | `opencode.jsonc` | `config.yaml` | ## Common Workflows ### Create a work profile from current config ```bash bridle profile create claude work --from-current ``` ### Create profile from existing profile (duplicate & modify) ```bash # 1. Switch to the source profile bridle profile switch opencode default # 2. Create new profile from current (now the source profile) bridle profile create opencode minimal --from-current # 3. Edit the new profile to remove/modify as needed bridle profile edit opencode minimal ``` ### Switch between profiles ```bash bridle profile switch claude personal bridle profile switch opencode minimal ``` ### Check status across all harnesses ```bash bridle status ```