br -- Beads Rust Issue Tracker (Official Skill)

Non-invasive: br NEVER runs git commands. Sync and commit are YOUR responsibility.

Critical Rules for Agents

Rule	Why
Binary is `br`	NEVER `bd` (that is the old Go version)
ALWAYS use `--json`	Structured output for parsing; `--format toon` for reduced tokens
NEVER run bare `bv`	Blocks session in interactive TUI mode
Sync is EXPLICIT	`br sync --flush-only` exports DB to JSONL only
Git is YOUR job	br only touches `.beads/` -- you must `git add .beads/ && git commit`
No cycles allowed	`br dep cycles` must return empty
Resolve actor at runtime	Use `ACTOR="${BR_ACTOR:-assistant}"` and pass `--actor "$ACTOR"`

Related skills