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
```