beads/examples
Steve Yegge 23bbdc7afa feat(mcp): Setup beads-mcp for PyPI distribution
Prepared the beads-mcp package for publishing to PyPI, simplifying installation
for users who want to use the MCP server with Claude Desktop or other MCP clients.

Changes:
- Added LICENSE file (MIT) to integrations/beads-mcp/
- Updated pyproject.toml with PyPI metadata (license, URLs, classifiers)
- Updated README with simplified installation (uv tool install beads-mcp)
- Created PYPI.md with detailed publishing guide
- Updated examples/claude-desktop-mcp/README to reference the production MCP server

Installation is now simplified from:
  git clone && cd && uv sync
to:
  uv tool install beads-mcp

Configuration is simplified from multi-line with --directory args to:
  "command": "beads-mcp"

Tested build successfully. Package ready for:
- Test PyPI: python -m twine upload --repository testpypi dist/*
- Production PyPI: python -m twine upload dist/*

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-14 18:07:22 -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 feat(mcp): Setup beads-mcp for PyPI distribution 2025-10-14 18:07:22 -07:00
git-hooks Implement auto-import to complete automatic git sync workflow 2025-10-13 22:48:30 -07:00
markdown-to-jsonl feat: Add markdown-to-jsonl converter example [addresses #9] 2025-10-14 13:24:20 -07:00
python-agent Prepare for public launch: comprehensive examples, docs, and tooling 2025-10-12 11:25:29 -07:00
README.md feat: Add markdown-to-jsonl converter example [addresses #9] 2025-10-14 13:24:20 -07:00

Beads Examples

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

Examples

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.