beads/docs/integrations/index.md
Chris Sells 69e33099b8 docs: apply PR #4722 review feedback to user docs
- FAQ: fix bulk migration/export commands (tracker pull/push need explicit
  IDs; bulk lives on sync --pull-only / --pull / --push-only / --push) and
  correct the cross-project isolation claim (hydration + external targets)
- quickstart: replace the broken DOLT.md blob URL with site links
- installation: Quick Install Script heading matches its macOS/Linux/FreeBSD
  body
- rewrite 33 stale SCREAMING_CASE link labels to the target pages' titles
- add description frontmatter to the 55 authored pages missing it
- docs.json: wildcard redirects for the old /next/ and version-prefixed
  route spaces (1.0.0, 1.0.4, 1.0.5)
2026-07-12 11:06:57 -07:00

2.2 KiB

title description
Integrations Browse every beads editor and agent integration, from bd setup recipes to MCP-based clients

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.