Broad dumb questions

[pelicans45]

• Will this probably work well for both Claude Code with Opus 4.5 and Jules (Google's cloud agent) with Gemini 3? GEMINI.md and CLAUDE.md both symlinked to AGENTS.md

• I work with a team and sometimes we use branches and sometimes we don't. Should I still probably use bd init --team?

• If members on the team are using all sorts of different agents (Claude Code, Codex, etc.) should it still be fine to keep beads git-synced?

[peterloron]

I can't speak to the team flag, but offhand I don't see any reason this wouldn't work with any tool/model as long as it can be fed the instructions.

[steveyegge]

Great questions! Let me address each:

1. Multi-agent compatibility (Claude Code + Jules/Gemini)

Yes, beads is agent-agnostic. It's a CLI tool that any agent can use as long as it can run shell commands. The symlink approach (GEMINI.md → AGENTS.md) works well - just make sure your AGENTS.md includes the beads workflow instructions. The key is that agents learn to call bd create, bd list, bd close, etc.

2. Team mode (bd init --team)

The --team flag runs a setup wizard that configures:

• Protected branch handling - if your main branch is protected, it can set up a separate beads-metadata branch for issue commits
• Auto-sync settings - configures the daemon for auto-commit and auto-push
• Team collaboration - sets team.enabled = true

If you're using branches sometimes but not always, --team is still useful for the auto-sync configuration. You can always run bd config later to adjust settings.

3. Mixed agent teams (Claude Code, Codex, etc.)

Should work fine! Beads uses git for sync, and the merge driver handles concurrent edits. The ID system is adaptive - it automatically uses longer hash IDs as your issue count grows to minimize collision risk. With the default settings:

• 3 chars: good for up to ~160 issues
• 4 chars: up to ~980 issues
• 5 chars: up to ~5.9K issues

The main consideration is making sure each agent's instruction file includes the beads workflow. Most agents that can run shell commands should work.

[steveyegge]

p.s. my name is Bob and I approve this message

[pelicans45]

Thanks!