beads/docs/integrations/gemini.md
Chris Sells a86a2c5dfc docs: port user docs into the Mintlify site tree under docs/
Port the website's current (non-versioned) authored pages into docs/ as
Mintlify pages: frontmatter title as H1 (body H1s removed), Docusaurus
admonitions converted to Mintlify components, root-relative extensionless
links, mermaid fences kept as-is. website/docs/** is untouched and keeps
serving the Docusaurus site until cutover.

git-mv the user-facing docs/ originals with no website twin into the new
IA (core-concepts/, architecture/, workflows/, recovery/, multi-agent/,
integrations/, reference/), converted to Mintlify form. The six files
previously mirrored by sync-website-docs.sh now live once in the site.
ERROR_HANDLING.md and CONTRIBUTOR_NAMESPACE_ISOLATION.md move to engdocs/
(contributor pattern guide and design doc per content review).

Pointer stubs remain at docs/{DOLT,STORAGE-BACKENDS,PLUGIN,RECOVERY,
JSON_SCHEMA}.md because released bd binaries print those paths; QUICKSTART
and DOLT-BACKEND stay as existing pointer stubs.

Corrected while porting: the intro's storage diagram claimed data lives at
.beads/dolt/; embedded mode (the default) uses .beads/embeddeddolt/
(internal/storage/embeddeddolt/store.go), server mode uses .beads/dolt/.
2026-07-12 10:37:07 -07:00

705 B

title
Gemini CLI

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