Bridle

# Bridle Skill

AI 编码助手的统一配置管理器。管理配置文件，安装技能/代理/命令，并在 Claude Code、OpenCode、Goose 和 Amp 之间切换配置。

## 安装

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

## 核心概念

- **Harnesses（工具）**：AI 编码助手（`claude`、`opencode`、`goose`、`amp`） - **Profiles（配置文件）**：每个工具的已保存配置（例如 `work`、`personal`、`minimal`）

## 快速命令

```bash # Launch interactive TUI bridle

# Show active profiles across all harnesses bridle status

# Initialize bridle config and default profiles bridle init ```

## 配置文件管理

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

## 安装组件

Bridle 可以从 GitHub 仓库安装技能、代理、命令和 MCP，并自动为每个工具转换路径/配置。

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

## 配置

配置位置：`~/.config/bridle/config.toml`

```bash # Get a config value bridle config get <key>

# Set a config value bridle config set <key> <value> ```

**配置键：** `profile_marker`、`editor`、`tui.view`、`default_harness`

## 输出格式

所有命令都支持 `-o, --output <format>`： - `text`（默认）— 人类可读 - `json` — 机器可读 - `auto` — TTY 输出文本，管道输出 JSON

## 支持的工具与配置位置

| Harness | 配置位置 | 状态 | | ----------- | ----------------------- | ------------ | | Claude Code | `~/.claude/` | 完全支持 | | OpenCode | `~/.config/opencode/` | 完全支持 | | Goose | `~/.config/goose/` | 完全支持 | | Amp | `~/.amp/` | 实验性支持 |

## 各工具的组件路径

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

## 常见工作流

### 从当前配置创建工作配置文件 ```bash bridle profile create claude work --from-current ```

### 从现有配置文件创建配置文件（复制并修改） ```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 ```

### 在配置文件之间切换 ```bash bridle profile switch claude personal bridle profile switch opencode minimal ```

### 检查所有工具的状态 ```bash bridle status ```