beads/docs/integrations/gemini.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

820 B

title description
Gemini CLI Set up beads for Gemini CLI with SessionStart hooks that run bd prime and GEMINI.md workflow guidance

Use Beads with Gemini CLI through SessionStart hooks and GEMINI.md guidance.

bd setup gemini
bd setup gemini --check

By default, setup installs global hooks in ~/.gemini/settings.json. For project-local hooks, use:

bd setup gemini --project

The hook runs bd prime --hook-json so Gemini receives compact Beads workflow context at session start. The setup also writes Beads guidance to GEMINI.md.

Stealth Mode

For CI or other environments where setup should avoid git operations:

bd setup gemini --stealth
bd setup gemini --project --stealth

Remove

bd setup gemini --remove
bd setup gemini --project --remove