Guide for using Beads (bd), a dependency-aware issue tracker for AI agents. Issues chained together like beads.
The English summary is being prepared. Showing the original description.
See how to installReview the instructions the agent will receive before you install.
Issues chained together like beads. A lightweight issue tracker with first-class dependency support.
bd init # Initialize bd in your project
bd init --prefix api # Initialize with custom prefix (api-1, api-2)
bd create "Fix login bug"
bd create "Add auth" -p 0 -t feature
bd create "Write tests" -d "Unit tests for auth" --assignee alice
bd list # List all issues
bd list --status open # List by status
bd list --priority 0 # List by priority (0-4, 0=highest)
bd show bd-1 # Show issue details
bd dep add bd-1 bd-2 # Add dependency (bd-2 blocks bd-1)
bd dep tree bd-1 # Visualize dependency tree
bd dep cycles # Detect circular dependencies
Dependency Types:
blocks - Task B must complete before task Arelated - Soft connection, doesn't block progressparent-child - Epic/subtask hierarchical relationshipdiscovered-from - Auto-created when AI discovers related workbd ready # Show issues ready to work on
Ready = status is 'open' AND no blocking dependencies. Perfect for agents to claim next work!
bd update bd-1 --status in_progress
bd update bd-1 --priority 0
bd update bd-1 --assignee bob
bd close bd-1
bd close bd-2 bd-3 --reason "Fixed in PR #42"
bd automatically discovers your database:
--db /path/to/db.db flag$BEADS_DB environment variable.beads/*.db in current directory or ancestors~/.beads/default.db as fallbackbd is designed for AI-supervised workflows:
bd ready shows unblocked work ready to claim--json flags for programmatic parsingbd automatically keeps git in sync:
Disable with: --no-auto-flush or --no-auto-import
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Model ElevenLabs voice synthesis as an ACSet schema with Unison ability handlers for typed voice operations. Use when integrating ElevenLabs TTS into category-theoretic pipelines, building typed voice synthesis workflows, or managing multi-voice narration with GF(3) conservation.
The English summary is being prepared. Showing the original description.
Systematic process for analyzing and modernizing legacy applications to comply with the 12-Factor App methodology. Covers code analysis, configuration externalization, dependency management, and container/Kubernetes best practices.
The English summary is being prepared. Showing the original description.
Gay MCP skill at invocation 26
The English summary is being prepared. Showing the original description.
Gay MCP skill at invocation 5
The English summary is being prepared. Showing the original description.
Gay MCP skill at invocation 27
The English summary is being prepared. Showing the original description.
Gay MCP skill at invocation 3
The English summary is being prepared. Showing the original description.