beads/examples
maphew 4f60f320cf docs: remove stale daemon refs and bd sync --status/--merge references
Fix #1982: Remove obsolete 'bd daemon' references from docs that
survived the daemon-to-Dolt migration. Files cleaned:
- docs/ERROR_HANDLING.md (daemon_sync.go → sync.go)
- docs/COMMUNITY_TOOLS.md (remove DaemonSocket reference)
- docs/dev-notes/TEST_SUITE_AUDIT.md (note daemon tests removed)
- docs/dev-notes/ERROR_HANDLING_AUDIT.md (daemon_sync.go → sync.go)

Fix #2007: Replace stale 'bd sync --status' and 'bd sync --merge'
references with current equivalents (bd dolt show, git merge, etc.).
bd sync is now a deprecated no-op. Files cleaned:
- docs/GIT_INTEGRATION.md
- docs/PROTECTED_BRANCHES.md
- examples/protected-branch/README.md
- claude-plugin/commands/sync.md (rewritten as deprecation notice)

Amp-Thread-ID: https://ampcode.com/threads/T-019ca749-d4f2-7289-b085-52e17436e950
Co-authored-by: Amp <amp@ampcode.com>
2026-02-28 19:54:49 -07:00
..
bash-agent docs(claim): standardize start-work semantics to --claim (#2070) 2026-02-24 22:11:39 -08:00
bd-example-extension-go feat(init): add --database flag to configure existing server database (#2102) 2026-02-24 22:26:07 -08:00
claude-desktop-mcp bd sync: 2025-11-26 18:07:01 2025-11-26 18:07:01 -08:00
compaction Update link to install script (#867) 2026-01-03 12:53:58 -08:00
contributor-workflow docs: remove stale JSONL references from ~73 markdown files (bd-9ni.4) 2026-02-22 22:18:02 -08:00
library-usage feat(init): add --database flag to configure existing server database (#2102) 2026-02-24 22:26:07 -08:00
linear-workflow docs(claim): standardize start-work semantics to --claim (#2070) 2026-02-24 22:11:39 -08:00
multi-phase-development docs(claim): standardize start-work semantics to --claim (#2070) 2026-02-24 22:11:39 -08:00
multiple-personas docs(claim): standardize start-work semantics to --claim (#2070) 2026-02-24 22:11:39 -08:00
protected-branch docs: remove stale daemon refs and bd sync --status/--merge references 2026-02-28 19:54:49 -07:00
python-agent refactor: Remove legacy MCP Agent Mail integration (bd-6gd) 2025-12-17 23:14:23 -08:00
startup-hooks feat: Add agent upgrade awareness documentation and tooling 2025-11-23 16:29:56 -08:00
team-workflow docs(claim): standardize start-work semantics to --claim (#2070) 2026-02-24 22:11:39 -08:00
README.md docs(claim): standardize start-work semantics to --claim (#2070) 2026-02-24 22:11:39 -08:00

Beads Examples

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

Examples

Agent Integration

Tools & Utilities

  • monitor-webui/ - Standalone web interface for real-time issue monitoring and visualization
  • git-hooks/ - Pre-configured git hooks for automatic Dolt sync

Workflow Patterns

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

# REMOVED (bd-4c74): branch-merge demo - hash IDs eliminate collision resolution

Creating Your Own Agent

The basic agent workflow:

  1. Find ready work: bd ready --json --limit 1
  2. Claim the task: bd update <id> --claim --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.