名称： bridle
描述： AI 编程助手的统一配置管理器。管理配置文件、安装技能/代理/命令，并在 Claude Code、OpenCode、Goose 和 Amp 之间切换配置。
作者： Benjamin Jesuiter bjesuiter@gmail.com
元数据：
clawdbot:
emoji: "🐴"
os: ["darwin", "linux"]
requires:
bins: ["bridle"]
install:
- id: brew
kind: brew
formula: neiii/bridle/bridle
bins: ["bridle"]
label: 通过 Homebrew 安装 bridle
- id: cargo
kind: shell
command: cargo install bridle
bins: ["bridle"]
label: 通过 Cargo 安装 bridle

Bridle 技能

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

安装

# Homebrew (macOS/Linux)
brew install neiii/bridle/bridle

# Cargo (Rust)
cargo install bridle

# 从源码安装
git clone https://github.com/neiii/bridle && cd bridle && cargo install --path .

核心概念

• Harnesses（套件）: AI 编程助手 (claude, opencode, goose, amp)
• Profiles（配置文件）: 每个套件的保存配置（例如 work, personal, minimal）

快速命令

# 启动交互式 TUI
bridle

# 显示所有套件的活动配置文件
bridle status

# 初始化 bridle 配置和默认配置文件
bridle init

配置文件管理

# 列出某个套件的所有配置文件
bridle profile list <harness>

# 显示配置文件详情（模型、MCPs、插件）
bridle profile show <harness> <name>

# 创建空配置文件
bridle profile create <harness> <name>

# 基于当前配置创建配置文件
bridle profile create <harness> <name> --from-current

# 切换/激活配置文件
bridle profile switch <harness> <name>

# 在编辑器中打开配置文件
bridle profile edit <harness> <name>

# 比较配置文件
bridle profile diff <harness> <name> [other]

# 删除配置文件
bridle profile delete <harness> <name>

安装组件

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

# 从 GitHub 安装（owner/repo 或完整 URL）
bridle install owner/repo

# 覆盖现有安装
bridle install owner/repo --force

# 交互式移除组件 [实验性功能]
bridle uninstall <harness> <profile>

配置

配置文件位置：~/.config/bridle/config.toml

# 获取配置值
bridle config get <key>

# 设置配置值
bridle config set <key> <value>

配置键： profile_marker, editor, tui.view, default_harness

输出格式

所有命令都支持 -o, --output <format> 选项：
- text（默认）— 人类可读格式
- json — 机器可读格式
- auto — 在 TTY 中使用文本格式，在管道中使用 JSON 格式

支持的套件及配置位置

各套件的组件路径

常用工作流

基于当前配置创建工作配置文件

bridle profile create claude work --from-current

基于现有配置文件创建（复制并修改）

# 1. 切换到源配置文件
bridle profile switch opencode default

# 2. 基于当前配置（即源配置文件）创建新配置文件
bridle profile create opencode minimal --from-current

# 3. 编辑新配置文件，按需删除/修改内容
bridle profile edit opencode minimal

在配置文件之间切换

bridle profile switch claude personal
bridle profile switch opencode minimal

检查所有套件的状态

bridle status