> ## Documentation Index
> Fetch the complete documentation index at: https://beads.gascity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

```bash theme={null}
bd setup gemini
bd setup gemini --check
```

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

```bash theme={null}
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:

```bash theme={null}
bd setup gemini --stealth
bd setup gemini --project --stealth
```

## Remove

```bash theme={null}
bd setup gemini --remove
bd setup gemini --project --remove
```