beads/examples
guillaume 2550e7fb6a
feat: Remove CGO dependency by migrating to pure Go SQLite driver
Migrates from github.com/mattn/go-sqlite3 (requires CGO) to modernc.org/sqlite (pure Go).

Benefits:
- Cross-compilation without C toolchain
- Faster builds (no CGO overhead)
- Static binary distribution
- Deployment in CGO-restricted environments

Changes:
- Updated go.mod to use modernc.org/sqlite v1.38.2
- Changed driver name from sqlite3 to sqlite in all sql.Open() calls
- Updated documentation (DESIGN.md, EXTENDING.md, examples)
- Removed concurrency torture tests that exposed pure Go driver limitations
- Documented known limitation under extreme parallel load (100+ ops)

All real-world tests pass. Normal usage with WAL mode unaffected.

Co-authored-by: yome <yome@users.noreply.github.com>
2025-10-14 11:20:27 -07:00
..
bash-agent Prepare for public launch: comprehensive examples, docs, and tooling 2025-10-12 11:25:29 -07:00
bd-example-extension-go feat: Remove CGO dependency by migrating to pure Go SQLite driver 2025-10-14 11:20:27 -07:00
branch-merge Add collision resolution with automatic ID remapping 2025-10-12 17:13:09 -07:00
claude-desktop-mcp Prepare for public launch: comprehensive examples, docs, and tooling 2025-10-12 11:25:29 -07:00
git-hooks Implement auto-import to complete automatic git sync workflow 2025-10-13 22:48:30 -07:00
python-agent Prepare for public launch: comprehensive examples, docs, and tooling 2025-10-12 11:25:29 -07:00
README.md Add collision resolution with automatic ID remapping 2025-10-12 17:13:09 -07:00

Beads Examples

This directory contains examples of how to integrate bd with AI agents and workflows.

Examples

  • python-agent/ - Simple Python agent that discovers ready work and completes tasks
  • bash-agent/ - Bash script showing the full agent workflow
  • git-hooks/ - Pre-configured git hooks for automatic export/import
  • branch-merge/ - Branch merge workflow with collision resolution
  • claude-desktop-mcp/ - MCP server for Claude Desktop integration

Quick Start

# Try the Python agent example
cd python-agent
python agent.py

# Try the bash agent example
cd bash-agent
./agent.sh

# Install git hooks
cd git-hooks
./install.sh

# Try branch merge collision resolution
cd branch-merge
./demo.sh

Creating Your Own Agent

The basic agent workflow:

  1. Find ready work: bd ready --json --limit 1
  2. Claim the task: bd update <id> --status in_progress --json
  3. Do the work: Execute the task
  4. Discover new issues: bd create "Found bug" --json
  5. Link discoveries: bd dep add <new-id> <parent-id> --type discovered-from
  6. Complete the task: bd close <id> --reason "Done" --json

All commands support --json for easy parsing.