br

Installation
SKILL.md

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"

Quick Workflow

Related skills
Installs
1
GitHub Stars
2
First Seen
Mar 20, 2026