braid scope

Configure which profiles and projects braid install pulls from.

Usage

braid scope [options]

Runs an interactive wizard that creates or updates either braid.json or braid.user.json.

Option	Description
`--file <target>`	Config file target: `user` or `project`
`--organization <type>`	Non-interactive: `personal` or `organization`
`--source <source>`	Non-interactive: `profile` or `manual`
`--profile <name>`	Profile name for non-interactive mode
`--projects <ids>`	Comma-separated project IDs for non-interactive mode
`--rule-ids <ids>`	Comma-separated included rule IDs
`--excluded-rule-ids <ids>`	Comma-separated excluded rule IDs
`--include-user-global`	Include personal global rules
`--include-org-global`	Include organization global rules
`-s, --server <url>`	Override the braid server URL

Interactive:

braid scope

Write user-level config non-interactively:

braid scope --file user --organization personal --source profile --profile default

Write project config with manual project selection:

braid scope --file project --organization organization --source manual --projects proj_a,proj_b --include-org-global

Project-level configuration. Commit this to version control so your whole team uses the same scope.

{
  "profile": "coding-standards",
  "agents": ["claude-code", "cursor"]
}

User-level overrides. Add to .gitignore for personal preferences that don’t apply to the team.