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

# 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

# Launch interactive TUI
bridle

# Show active profiles across all harnesses
bridle status

# Initialize bridle config and default profiles
bridle init

Profile Management

# 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.

# 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

# 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

| --------- | ----------- | -------- | ----- |

| Agents | ~/.claude/plugins/*/agents/ | ~/.config/opencode/agent/ | — |

| Commands | ~/.claude/plugins/*/commands/ | ~/.config/opencode/command/ | — |

Common Workflows

Create a work profile from current config

bridle profile create claude work --from-current

Create profile from existing profile (duplicate & modify)

# 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

bridle profile switch claude personal
bridle profile switch opencode minimal

Check status across all harnesses

bridle status