alex
722d608491
CI / check (push) Has been cancelled
Agents were told to run bd commands that beads_rust does not have (bd prime, bd remember, bd dolt push, bd tag, bd note, bd children), and bd's git hooks were still active, so bd could re-export its stale dolt state over br's JSONL on commit. - Rewrite AGENTS.md, docs/agents/issue-tracker.md, docs/agents/triage-labels.md and the .serena memories around br's real CLI surface - Replace bd's generated AGENTS.md block with br's (br agents --add) - Point the .claude session hooks at `br robot-docs guide` - Remove bd git hooks and unset core.hooksPath; br installs no hooks - Ignore br runtime files (local SQLite DB, recovery and merge artifacts) - Rewrite .beads/README.md, config.yaml and metadata.json for br Issue: nix-overlay-6pp
Beads - AI-Native Issue Tracking
This repository uses beads_rust (br) for issue tracking. Issues live next to the code in .beads/, so no web UI is needed.
Where the state lives
.beads/issues.jsonl— the versioned source of truth. It is committed to git, so issue state travels withgit push..beads/dolt— the local SQLite database used bybr(runtime only, not versioned)..beads/config.yaml— project settings.
br never runs git commands. After br sync --flush-only you must run git add .beads/ && git commit yourself.
Essential commands
br robot-docs guide # session context and command reference (run first)
br ready # unblocked, non-deferred issues
br list # all issues
br show <issue-id> # issue detail
br create "Title" # create an issue
br update <id> --claim # claim work before starting
br close <id> # close an issue
br sync --flush-only # export the database to issues.jsonl
Learn more
- Repository: https://github.com/Dicklesworthstone/beads_rust
- Agent guide:
br robot-docs guide