braid docs

braid rules

Manage rules in your braid account from the command line.

Subcommands

SubcommandDescription
listList available rules for a scope
getGet a rule by ID
createCreate a new rule
updateUpdate a rule
removeDelete a rule
enableEnable a disabled rule
disableDisable a rule
moveMove a rule to a different project
duplicateDuplicate a rule
forkFork a rule (creates a linked copy)

Sync subcommands

Rules can sync with upstream sources. These commands manage sync state:

SubcommandDescription
sync-statusShow sync status for one rule or all rules
sync-historyShow sync history for a rule
sync-enableEnable sync for a rule
sync-disableDisable sync for a rule
sync-checkCheck for upstream updates
sync-nowRun sync immediately

Examples

Create a rule:

braid rules create \
  --title "Conventional Commits" \
  --content "Use conventional commits: type(scope): description" \
  --tags "git,commits"

List rules with JSON output:

braid rules list --json

Fork a rule to another project:

braid rules fork --id <rule-id> --target-project-id <project-id>

Check sync status across all rules:

braid rules sync-status