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