Description

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

README (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

Usage Guidance

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.

Capability Analysis

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.

Capability Assessment

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

Version History

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

Metadata

Slug bridle

Version 1.1.0

License —

All-time Installs 0

Active Installs 0

Total Versions 3

Frequently Asked Questions

What is Bridle?

Unified configuration manager for AI coding assistants. Manage profiles, install skills/agents/commands, and switch configurations across Claude Code, OpenCode, Goose, and Amp. It is an AI Agent Skill for Claude Code / OpenClaw, with 2502 downloads so far.

How do I install Bridle?

Run "/install bridle" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Bridle free?

Yes, Bridle is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Bridle support?

Bridle is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux).

Who created Bridle?

It is built and maintained by bjesuiter (@bjesuiter); the current version is v1.1.0.

More Skills

Bridle