I tweak the default beads setup to work with Claude instead of the generic agent integration.
As of beads 0.62.0, this is what I run:
# configure agents later
bd init --shared-server --skip-agents
# setup a CLAUDE.md and configure claude hooks to re-prime beads
bd setup claude --project
bd hooks install
# move local settings to project settings
mv .claude/settings{.local,}.json
# amend init commit so .beads-credential-key never enters git
git add .claude/settings.json CLAUDE.md
git commit --amend -CHEAD
# share beads data alongside your git repo
bd dolt remote add origin git+ssh://[email protected]/you/repo.git
echo -e 'sync:\n git-remote: git+ssh://[email protected]/you/repo.git' >> .beads/config.yamlThe key thing is --skip-agents and then bd setup claude --project instead, so you get Claude-specific hooks rather than the generic agent integration. The dolt remote lines are so your beads data gets stored alongside your git repo.