Beads (bd) is a git-native issue tracker that stores issues as JSONL files within the repository itself. This eliminates the need for external issue tracking systems while keeping issues versioned alongside code.

• Repository: github.com/aygp-dr/beads
• Install: cargo install beads or build from source

Current deployment across projects:

Beads integrates well with Claude Code workflows:

1. Issue Creation: Use bd create during conversations to track discovered work
2. Issue Discovery: bd list to find outstanding tasks
3. Progress Tracking: Mark issues in_progress or ready as work begins
4. Completion: bd close when work is done and committed

Example workflow:

# Discover a bug during development
bd create -t "API returns 500 on empty input" -y bug -p high

# Later, when working on it
bd ready www.wal.sh-42
# ... fix the bug ...
bd close www.wal.sh-42

Issues are stored in .beads/issues.jsonl:

{"id":"proj-1","title":"Add auth","type":"feature","status":"open","priority":"medium","created":"2025-12-01T10:00:00Z"}
{"id":"proj-2","title":"Fix typo","type":"bug","status":"closed","priority":"low","created":"2025-12-02T14:30:00Z"}

Benefits:

• Issues travel with the repository
• Full git history for issue changes
• Works offline
• No external service dependencies
• Merge conflicts are human-readable

Active projects with beads tracking:

• www.wal.sh - 110 open issues
• advent-of-code - 170 issues
• beads (self-tracking) - 857 issues
• agent-token-exchange - simulation tracking
• go-agentic-workshop - workshop exercises

• Terminal AI Agents - Claude Code and other CLI agents
• Local-First Software - offline-first patterns