GEMINI.md

1# Gemini CLI — setup guide
2 
3> The canonical context file is [`AGENTS.md`](AGENTS.md) at the repo root. Gemini CLI reads it via `.gemini/settings.json` (`context.fileName`). This guide covers Gemini-specific setup only.
4 
5## Install
6 
7```bash
8gemini extensions install https://github.com/wshobson/agents
9cd ~/.gemini/extensions/claude-code-workflows
10make generate HARNESS=gemini
11# restart Gemini CLI
12```
13 
14## What you get
15 
16- **156 skills** at `skills/<plugin>__<skill>/SKILL.md` — described in `AGENTS.md`. Describe a task to activate.
17- **192 subagents** at `agents/<plugin>__<agent>.md` — invoke with `@<agent>`.
18- **102 slash commands** at `/<plugin>:<command>` — use `/help` to list.
19 
20## Companion Memory Extension
21 
22Pensyve is maintained upstream as a separate Gemini CLI extension with MCP-backed
23memory and context injection:
24 
25```bash
26gemini extensions install https://github.com/major7apps/pensyve
27```
28 
29## Gemini-specific differences
30 
31| Capability | Claude Code | Gemini CLI |
32|---|---|---|
33| Plugin installation | `/plugin install` | `gemini extensions install <url>` |
34| Context file | reads `CLAUDE.md` (a symlink to `AGENTS.md`) | reads via `.gemini/settings.json` redirect to AGENTS.md |
35| Per-agent tool allowlist | `tools:` (always) | `tools:` (honored — remapped to Gemini-native names) |
36| Skill / agent discovery | native | native (skills/, agents/ at extension root) |
37| Model assignment | per-agent | session-level (override via `model:` frontmatter) |
38| `TodoWrite` tool | yes | no equivalent |
39 
40## Regenerating
41 
42```bash
43make generate HARNESS=gemini                            # all plugins
44make generate HARNESS=gemini PLUGIN=javascript-typescript   # one plugin
45make clean-generated HARNESS=gemini                     # remove output
46```
47 
48## See also
49 
50- [`AGENTS.md`](AGENTS.md) — canonical context (cross-harness conventions)
51- [`docs/harnesses.md`](docs/harnesses.md) — full capability matrix
52- [`docs/round-trip-results.md`](docs/round-trip-results.md) — Gemini round-trip verification recipe
53