mirror of
https://github.com/wshobson/agents
synced 2026-06-21 14:13:58 +00:00
Seth Hobson
767d969a73
PR #558 updated the headline totals but left trailing references at 83/191/155 across README, AGENTS.md, GEMINI.md, ARCHITECTURE.md, and docs/*. Sync them all to the true counts (82 local + 2 external = 84 plugins, 192 agents, 156 skills). Also runs make generate-all to bring the committed harness registries in sync — adds the social-publishing entries to .agents/ and .cursor-plugin/ (which the original PR could not regenerate) and fixes the stale count in the generated cursor manifests. Left round-trip-results.md (point-in-time CLI verification results) and plugin-eval.md (grade threshold) unchanged.
53 lines
2.0 KiB
Markdown
53 lines
2.0 KiB
Markdown
# Gemini CLI — setup guide
|
|
|
|
> 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.
|
|
|
|
## Install
|
|
|
|
```bash
|
|
gemini extensions install https://github.com/wshobson/agents
|
|
cd ~/.gemini/extensions/claude-code-workflows
|
|
make generate HARNESS=gemini
|
|
# restart Gemini CLI
|
|
```
|
|
|
|
## What you get
|
|
|
|
- **156 skills** at `skills/<plugin>__<skill>/SKILL.md` — described in `AGENTS.md`. Describe a task to activate.
|
|
- **192 subagents** at `agents/<plugin>__<agent>.md` — invoke with `@<agent>`.
|
|
- **102 slash commands** at `/<plugin>:<command>` — use `/help` to list.
|
|
|
|
## Companion Memory Extension
|
|
|
|
Pensyve is maintained upstream as a separate Gemini CLI extension with MCP-backed
|
|
memory and context injection:
|
|
|
|
```bash
|
|
gemini extensions install https://github.com/major7apps/pensyve
|
|
```
|
|
|
|
## Gemini-specific differences
|
|
|
|
| Capability | Claude Code | Gemini CLI |
|
|
|---|---|---|
|
|
| Plugin installation | `/plugin install` | `gemini extensions install <url>` |
|
|
| Context file | reads `CLAUDE.md` (a symlink to `AGENTS.md`) | reads via `.gemini/settings.json` redirect to AGENTS.md |
|
|
| Per-agent tool allowlist | `tools:` (always) | `tools:` (honored — remapped to Gemini-native names) |
|
|
| Skill / agent discovery | native | native (skills/, agents/ at extension root) |
|
|
| Model assignment | per-agent | session-level (override via `model:` frontmatter) |
|
|
| `TodoWrite` tool | yes | no equivalent |
|
|
|
|
## Regenerating
|
|
|
|
```bash
|
|
make generate HARNESS=gemini # all plugins
|
|
make generate HARNESS=gemini PLUGIN=javascript-typescript # one plugin
|
|
make clean-generated HARNESS=gemini # remove output
|
|
```
|
|
|
|
## See also
|
|
|
|
- [`AGENTS.md`](AGENTS.md) — canonical context (cross-harness conventions)
|
|
- [`docs/harnesses.md`](docs/harnesses.md) — full capability matrix
|
|
- [`docs/round-trip-results.md`](docs/round-trip-results.md) — Gemini round-trip verification recipe
|