- Rewrite docs/core-concepts/index.md as 'How Beads Works' — the one canonical concept page (modeled on Gas City's how-gas-city-works): problem-first framing, the bead -> dependencies -> ready-work loop, hash IDs, the formula -> proto -> molecule/wisp pipeline, gates, Dolt sync, federation, and storage modes, led by four mermaid diagrams. Other pages link here instead of re-deriving the model. - Fact fixes caught while writing (verified against source/live help): hash IDs are content-derived SHA-256 (internal/types/id_generator.go), not random; bd pour/bd wisp/bd pin/bd hook are not commands (the real surface is bd mol pour, bd mol wisp, bd assign, bd update --claim); wisps are not stored in .beads-wisp/; cross-repo dependency syntax is external:<project>:<capability> (cmd/bd/dep.go); recovery index claimed SQLite errors in a Dolt product. - Section overview pages: rewrite workflows/index, extend recovery, multi-agent, and integrations indexes to list every child with one-line summaries; add reference/index and put it in the nav. - New concept diagrams: sequential-vs-hash ID merge collision (core-concepts/hash-ids) and embedded-vs-server mode (architecture/dolt). - website/README.md: real build/verify instructions and parallel-run status for the Docusaurus site. - Repoint example READMEs and page labels at the real quickstart page.
2.1 KiB
2.1 KiB
| title |
|---|
| Integrations |
Beads integration pages are based on two sources of support in the repository:
- Built-in
bd setuprecipes frominternal/recipes/recipes.go - First-party MCP integrations and editor guides already shipped in the repo
Run this command to see the built-in setup recipes supported by your installed bd binary:
bd setup --list
Built-in Setup Recipes
| Recipe | Integration | Primary setup surface |
|---|---|---|
aider |
Aider | .aider.conf.yml and .aider/ instructions |
claude |
Claude Code | Claude hooks and CLAUDE.md |
codex |
Codex | Beads skill, AGENTS.md, and Codex hooks |
cody |
Sourcegraph Cody | .cody/rules/beads.md |
cursor |
Cursor | .cursor/rules/beads.mdc + .cursor/hooks.json |
factory |
Factory.ai Droid | AGENTS.md |
gemini |
Gemini CLI | Gemini hooks and GEMINI.md |
junie |
Junie | .junie/guidelines.md and MCP config |
kilocode |
Kilo Code | .kilocode/rules/beads.md |
mux |
Mux | AGENTS.md, optional .mux/AGENTS.md, and Mux hooks |
opencode |
OpenCode | AGENTS.md |
windsurf |
Windsurf | .windsurf/rules/beads.md |
MCP-Based Integrations
These integrations use the Beads MCP server rather than a dedicated bd setup recipe:
- MCP Server — the beads MCP server for any MCP-capable client.
- GitHub Copilot — Copilot in VS Code via MCP.
- GitHub Copilot CLI — the Copilot coding-agent CLI.
Other Integration Surfaces
- Claude Code Plugin — the packaged
plugin with slash commands and MCP tools (
/plugin install beads). - Azure DevOps — configuration reference for syncing beads with ADO work items.