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