bd agents setup
92 unmodified lines9394959697989910010110210310410510610710810911011111211311411511611711892 unmodified lines- NEVER stop before pushing - that leaves work stranded locally- NEVER say "ready to push when you are" - YOU must push- If push fails, resolve and retry until it succeeds<!-- END BEADS INTEGRATION -->
<!-- BEGIN BEADS CODEX SETUP: generated by bd setup codex -->## Beads Issue Tracker
Use Beads (`bd`) for durable task tracking in repositories that include it. Use the `beads` skill at `.agents/skills/beads/SKILL.md` (project install) or `~/.agents/skills/beads/SKILL.md` (global install) for Beads workflow guidance, then use the `bd` CLI for issue operations.
### Quick Reference
```bashbd ready # Find available workbd show <id> # View issue detailsbd update <id> --claim # Claim workbd close <id> # Complete workbd prime # Refresh Beads context```
### Rules
- Use `bd` for all task tracking; do not create markdown TODO lists.- Run `bd prime` when Beads context is missing or stale.- Keep persistent project memory in Beads via `bd remember`; do not create ad hoc memory files.<!-- END BEADS CODEX SETUP -->15 unmodified lines161718192021202122232424252627283 unmodified lines323334353637363738394040414243445 unmodified lines5051525354555455565758585960616215 unmodified lines15 unmodified lines } }, "nixpkgs": { "locked": { "lastModified": 1768783163, "narHash": "sha256-tLj4KcRDLakrlpvboTJDKsrp6z2XLwyQ4Zmo+w8KsY4=", "lastModified": 1782636521, "narHash": "sha256-OG8laCOGtkxlB1JH3XqOnXxnkGJme4mQdXo5hkhCQIY=", "owner": "nixos", "repo": "nixpkgs", "rev": "bde09022887110deb780067364a0818e89258968", "rev": "e1c1b84752fb0897897380a3cae9dc7fcab91ca3", "type": "github" }, "original": { "owner": "nixos",3 unmodified lines } }, "nixpkgs-lib": { "locked": { "lastModified": 1765674936, "narHash": "sha256-k00uTP4JNfmejrCLJOwdObYC9jHRrr/5M/a/8L2EIdo=", "lastModified": 1777168982, "narHash": "sha256-GOkGPcboWE9BmGCRMLX3worL4EMnsnG8MyKmXNeYuhQ=", "owner": "nix-community", "repo": "nixpkgs.lib", "rev": "2075416fcb47225d9b68ac469a5c4801a9c4dd85", "rev": "f5901329dade4a6ea039af1433fb087bd9c1fe14", "type": "github" }, "original": { "owner": "nix-community",5 unmodified lines "inputs": { "nixpkgs-lib": "nixpkgs-lib" }, "locked": { "lastModified": 1768135262, "narHash": "sha256-PVvu7OqHBGWN16zSi6tEmPwwHQ4rLPU9Plvs8/1TUBY=", "lastModified": 1778716662, "narHash": "sha256-m1Yf0wZ8j1OHjTc2UwHwyQRSnNeSgLJOd7q5Y45hzi4=", "owner": "hercules-ci", "repo": "flake-parts", "rev": "80daad04eddbbf5a4d883996a73f3f542fa437ac", "rev": "f7c1a2d347e4c52d5fb8d10cb4d94b5884e546fb", "type": "github" }, "original": { "owner": "hercules-ci",15 unmodified lines79 unmodified lines808182838485868788177 unmodified linesExpand all79 unmodified lines let group: ThreadGroup | undefined;
for (const uri of postUris) { if (!timeline.has(uri)) continue;
const did = extractDidFromUri(uri); if (!did) continue; const parts = uri.split('/'); if (parts.length < 5) continue;177 unmodified linesExpand all1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980---name: beadsdescription: Use when working in a repository that uses bd or Beads for durable project task tracking, issue dependencies, blocker management, multi-session handoff, or shared work memory. Trigger when the user asks to find ready work, claim or close tasks, create follow-up work, inspect blockers, recover project context, or choose between local planning and persistent project tracking.---
# Beads
Use Beads as the shared project task system. Local plans, scratch files, and personal memories are useful, but they are not the durable source of truth for project work.
## First Step
Run:
```bashbd prime```
If that prints nothing, check whether the repository has an active Beads workspace:
```bashbd where```
## Preferred Route
Use the `bd` CLI when shell access is available. It is the most compact and direct Beads interface.
## Core CLI Workflow
1. Find work:
```bashbd readybd list --status=openbd list --status=in_progress```
2. Inspect before editing:
```bashbd show <id>```
3. Claim work atomically:
```bashbd update <id> --claim```
4. Create durable follow-up work when implementation reveals new tasks:
```bashbd create "Short title" --description="Why this exists and what needs to be done" --type=task --priority=2```
5. Close completed work:
```bashbd close <id> --reason="Completed"```
## What Belongs In Beads
Use Beads for:
- shared project tasks- blockers and dependencies- discovered follow-up work- work that must survive thread reset, compaction, or handoff- status that another person or agent should be able to resume
Use agent-local planning tools only for the current turn's execution checklist. Do not treat them as shared project state.
## Rules
- Do not create markdown TODO files as the source of truth when Beads is available.- Do not use `bd edit`; it opens an interactive editor. Use `bd update` flags instead.- Prefer `--json` when parsing `bd` output programmatically.- If hooks are installed, `bd prime` may already be injected. Run it manually when context is missing.- Do not auto-close or mutate tasks unless the work is actually complete.1234interface: display_name: "Beads" short_description: "Project task tracking with bd" default_prompt: "Use $beads to inspect ready work and manage durable project tasks."