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
30 lines
1.1 KiB
Markdown
30 lines
1.1 KiB
Markdown
# Beads - AI-Native Issue Tracking
|
|
|
|
This repository uses [beads_rust](https://github.com/Dicklesworthstone/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 with `git push`.
|
|
- `.beads/dolt` — the local SQLite database used by `br` (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
|
|
|
|
```bash
|
|
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`
|