braid docs

CLI Reference

The braid CLI installs prompts — rules, skills, workflows, and sub-agents — to your AI coding tools as native files.

For marketplace installs, the CLI uses the same local-file pipeline. Buy or claim a pack in Braid, then run braid marketplace install <slug>.

Usage

braid <command> [options]

Commands

CommandDescription
installInstall prompts to your coding tools
authAuthenticate with braid
scopeConfigure which profiles and projects to install from
listList installed prompts
updateUpdate installed prompts to latest versions
removeRemove installed prompts
rulesCreate, update, and manage rules
profilesManage profiles
projectsManage projects
agentsManage sub-agent configurations
referencesManage rule reference files
marketplaceBrowse and install marketplace packs

Global options

OptionDescription
--versionShow CLI version
--helpShow help for any command
-s, --server <url>Custom server URL (review apps, local dev)

Configuration

The CLI reads from two config files:

  • braid.json — project-level config, committed to version control
  • braid.user.json — user-level overrides, gitignored

Both are created by braid scope.