功能描述

Unified configuration manager for AI coding assistants. Manage profiles, install skills/agents/commands, and switch configurations across Claude Code, OpenCode, Goose, and Amp.

使用说明 (SKILL.md)

Bridle Skill

Name: Bridle
Author: bjesuiter

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 \x3Charness>

# Show profile details (model, MCPs, plugins)
bridle profile show \x3Charness> \x3Cname>

# Create empty profile
bridle profile create \x3Charness> \x3Cname>

# Create profile from current config
bridle profile create \x3Charness> \x3Cname> --from-current

# Switch/activate a profile
bridle profile switch \x3Charness> \x3Cname>

# Open profile in editor
bridle profile edit \x3Charness> \x3Cname>

# Compare profiles
bridle profile diff \x3Charness> \x3Cname> [other]

# Delete a profile
bridle profile delete \x3Charness> \x3Cname>

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 \x3Charness> \x3Cprofile>

Configuration

Config location: ~/.config/bridle/config.toml

# Get a config value
bridle config get \x3Ckey>

# Set a config value
bridle config set \x3Ckey> \x3Cvalue>

Config keys: profile_marker, editor, tui.view, default_harness

Output Formats

All commands support -o, --output \x3Cformat>:

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

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

安全使用建议

This skill is coherent with its stated purpose (it wraps a 'bridle' CLI), but it will read and write configuration in multiple other AI harness directories and can install arbitrary GitHub repos into those locations. Before installing or running it: (1) verify the Homebrew tap / crate / upstream GitHub repo and review the source if possible; (2) back up the config directories listed (~/.claude, ~/.config/opencode, ~/.config/goose, ~/.amp, ~/.config/bridle); (3) prefer installing from reviewed source code rather than a third‑party binary if you don't trust the tap; (4) be cautious about running 'bridle install owner/repo' for untrusted repositories — those components can execute code within your agent environment; (5) expect the tool to need write access to your home config directories and potentially network/GitHub credentials for private repos. If you need higher assurance, inspect the bridle repository/formula and the code it would deploy before use.

功能分析

Type: OpenClaw Skill Name: bridle Version: 1.1.0 The skill bundle is classified as suspicious due to the `bridle install owner/repo` command described in `SKILL.md`. This command allows the `bridle` tool to download and install components from arbitrary GitHub repositories. While this capability is central to the tool's stated purpose of managing AI assistant components, it introduces a significant supply chain risk by granting broad permissions to fetch and potentially execute external code, which could be exploited if a malicious repository is specified by the user or the agent.

能力评估

ℹ Purpose & Capability

The name/description match the runtime instructions: the skill simply shells out to a 'bridle' binary that manages profiles and harness configs. However, the SKILL.md documents reading/writing many harness config paths (e.g., ~/.claude/, ~/.config/opencode/, ~/.config/goose/, ~/.config/bridle/config.toml) yet the skill metadata declares no required config paths. That omission is an inconsistency — the tool will need access to other tools' config directories but the skill does not explicitly request or document that access.

⚠ Instruction Scope

Runtime instructions tell the agent to run 'bridle' commands (init, profile create/switch/edit, install owner/repo) and reference specific user config locations. In particular, 'bridle install owner/repo' implies cloning/installing arbitrary GitHub repos into harness config directories. That capability can introduce untrusted code or modify other agents' configurations; the SKILL.md does not limit or qualify what will be installed or warn about validating code, so the instruction scope is broader and higher-risk than a simple config viewer/editor.

ℹ Install Mechanism

Install options are Homebrew (neiii/bridle/bridle), cargo install, or git clone/build. Homebrew uses a third‑party tap (neiii) rather than an official formula, which is a moderate trust consideration. cargo install/git clone are traceable to source but will build/run code locally. No opaque URL shorteners or unknown archive extracts are present, but you should verify the brew tap and crate/repo owners before installing.

ℹ Credentials

The skill declares no required environment variables or credentials, which fits a local CLI manager. However, the documented workflows (installing from GitHub, writing to other harness configs) may require network access and write access to ~/.config/ and other home directories, and they may prompt for credentials when accessing private repos — none of which are declared. That mismatch should be noted.

⚠ Persistence & Privilege

The skill is not always-on, but its described operations explicitly modify other harnesses' configuration directories and install components (skills/agents/commands) into them. Modifying other agents' or skills' configs is a meaningful privilege and increases blast radius: a malicious or buggy installed component could alter behavior across multiple AI assistants. The skill metadata does not document safeguards or required approvals for installations.

版本历史

v1.1.0

- Added explicit author field with contact information in the skill metadata. - Updated metadata formatting for improved readability and YAML structure. - No changes to core functionality or usage instructions.

v1.0.1

Fixed metadata format: moved homepage and version into metadata object for official agentskills compatibility.

v1.0.0

Initial release: profile management for Claude Code, OpenCode, Goose, Amp

元数据

Slug bridle

版本 1.1.0

许可证 —

累计安装 0

当前安装数 0

历史版本数 3

常见问题

Bridle 是什么？

Unified configuration manager for AI coding assistants. Manage profiles, install skills/agents/commands, and switch configurations across Claude Code, OpenCode, Goose, and Amp. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 2502 次。

如何安装 Bridle？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install bridle」即可一键安装，无需额外配置。

Bridle 是免费的吗？

是的，Bridle 完全免费（开源免费），可自由下载、安装和使用。

Bridle 支持哪些平台？

Bridle 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（darwin, linux）。

谁开发了 Bridle？

由 bjesuiter（@bjesuiter）开发并维护，当前版本 v1.1.0。

Bridle