beads/docs/integrations/index.md
Chris Sells 54a7547b0d docs: canonical concept page, section overviews, and concept diagrams
- 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.
2026-07-12 10:37:07 -07:00

2.1 KiB

title
Integrations

Beads integration pages are based on two sources of support in the repository:

  • Built-in bd setup recipes from internal/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:

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.