beads
par rnijhara
Marketing & SalesRésumé
Git-backed issue tracker for AI agents.
Description
Ce que fait ce skill
Distributed, git-backed issue tracker for AI agents. Stores tasks as JSONL in .beads/ with a dependency-aware graph that replaces markdown plans. Supports multi-agent coordination, hierarchical epics, and machine-readable output via --json flags.
Unlike markdown task lists, beads lets agents query unblocked work directly with structured JSON and enforces dependency ordering automatically.
Quand l'utiliser
- Tracking multi-step agent tasks with blocking dependencies
- Coordinating parallel work across multiple AI agents on one project
- Querying the next unblocked task in a project work queue
- Organizing large projects into epics with nested subtasks
- Persisting task state across sessions via git commits
Exemple de workflow
User asks: Plan and track a multi-step coding project with an AI agent
- 1
Run bd init --quiet to initialize the task database in .beads/
- 2
Run bd create for each task with priorities and dependency links using --json
- 3
Run bd ready --json to get the current unblocked work queue
- 4
Run bd update <id> --status in_progress --assignee agent-1 to claim a task
- 5
Run bd close <id> --reason "Done" then bd sync to commit and flush changes to git
Tasks stored in .beads/ as a dependency graph, committed to git, with remaining work surfaced for agent handoff
Prérequis
- bd CLI (install via brew install beads or npm install -g @beads/bd)
Installation
clawhub install rnijhara/beadsExécute la commande CLI, ou colle l'instruction dans Claude Code, Cursor, Codex ou l'agent de code que tu utilises.