From 6be431b772237efbde26dbb628c698675d6e2e32 Mon Sep 17 00:00:00 2001 From: Jesse Vincent Date: Wed, 24 Jun 2026 19:23:23 -0700 Subject: [PATCH] Remove Gemini CLI support Google EOLed the Gemini CLI on 2026-06-18; the extension can no longer be installed or updated. Remove Gemini from the install docs, the subagent-capable platform lists, and the eval-harness description, and delete its tool-mapping reference. --- CLAUDE.md | 2 +- README.md | 16 +---- skills/brainstorming/visual-companion.md | 7 --- skills/executing-plans/SKILL.md | 2 +- .../references/gemini-tools.md | 63 ------------------- skills/writing-skills/SKILL.md | 2 +- 6 files changed, 4 insertions(+), 88 deletions(-) delete mode 100644 skills/using-superpowers/references/gemini-tools.md diff --git a/CLAUDE.md b/CLAUDE.md index 5f3d7410..f8e45e9d 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -101,7 +101,7 @@ Skills are not prose — they are code that shapes agent behavior. If you modify ## Eval harness -Skill-behavior evals live in [superpowers-evals](https://github.com/prime-radiant-inc/superpowers-evals/), cloned into `evals/` — see `evals/README.md` for setup. Drill (the harness) drives real tmux sessions of Claude Code / Codex / Gemini CLI and judges skill compliance with an LLM verifier. Plugin-infrastructure tests still live at `tests/`. +Skill-behavior evals live in [superpowers-evals](https://github.com/prime-radiant-inc/superpowers-evals/), cloned into `evals/` — see `evals/README.md` for setup. The harness drives real tmux sessions of Claude Code / Codex and judges skill compliance with an LLM verifier. Plugin-infrastructure tests still live at `tests/`. ## Understand the Project Before Contributing diff --git a/README.md b/README.md index bb398c6b..48e3f198 100644 --- a/README.md +++ b/README.md @@ -11,7 +11,7 @@ If this sounds like someone you know, definitely send them our way. ## Quickstart -Give your agent Superpowers: [Claude Code](#claude-code), [Antigravity](#antigravity), [Codex App](#codex-app), [Codex CLI](#codex-cli), [Cursor](#cursor), [Factory Droid](#factory-droid), [Gemini CLI](#gemini-cli), [GitHub Copilot CLI](#github-copilot-cli), [Kimi Code](#kimi-code), [OpenCode](#opencode), [Pi](#pi). +Give your agent Superpowers: [Claude Code](#claude-code), [Antigravity](#antigravity), [Codex App](#codex-app), [Codex CLI](#codex-cli), [Cursor](#cursor), [Factory Droid](#factory-droid), [GitHub Copilot CLI](#github-copilot-cli), [Kimi Code](#kimi-code), [OpenCode](#opencode), [Pi](#pi). ## How it works @@ -122,20 +122,6 @@ Superpowers is available via the [official Codex plugin marketplace](https://git droid plugin install superpowers@superpowers ``` -### Gemini CLI - -- Install the extension: - - ```bash - gemini extensions install https://github.com/obra/superpowers - ``` - -- Update later: - - ```bash - gemini extensions update superpowers - ``` - ### GitHub Copilot CLI - Register the marketplace: diff --git a/skills/brainstorming/visual-companion.md b/skills/brainstorming/visual-companion.md index 906c9ac8..7b89f6b2 100644 --- a/skills/brainstorming/visual-companion.md +++ b/skills/brainstorming/visual-companion.md @@ -74,13 +74,6 @@ On Windows, the script auto-detects and switches to foreground mode (which block scripts/start-server.sh --project-dir /path/to/project --open ``` -**Gemini CLI:** -```bash -# Use --foreground and set is_background: true on your shell tool call -# so the process survives across turns -scripts/start-server.sh --project-dir /path/to/project --open --foreground -``` - **Copilot CLI:** ```bash # Use --foreground and start the server via the bash tool with mode: "async" diff --git a/skills/executing-plans/SKILL.md b/skills/executing-plans/SKILL.md index 78d88540..075a1038 100644 --- a/skills/executing-plans/SKILL.md +++ b/skills/executing-plans/SKILL.md @@ -11,7 +11,7 @@ Load plan, review critically, execute all tasks, report when complete. **Announce at start:** "I'm using the executing-plans skill to implement this plan." -**Note:** Tell your human partner that Superpowers works much better with access to subagents. The quality of its work will be significantly higher if run on a platform with subagent support (Claude Code, Codex CLI, Codex App, Copilot CLI, and Gemini CLI all qualify; see the per-platform tool refs in `../using-superpowers/references/`). If subagents are available, use superpowers:subagent-driven-development instead of this skill. +**Note:** Tell your human partner that Superpowers works much better with access to subagents. The quality of its work will be significantly higher if run on a platform with subagent support (Claude Code, Codex CLI, Codex App, and Copilot CLI all qualify; see the per-platform tool refs in `../using-superpowers/references/`). If subagents are available, use superpowers:subagent-driven-development instead of this skill. ## The Process diff --git a/skills/using-superpowers/references/gemini-tools.md b/skills/using-superpowers/references/gemini-tools.md deleted file mode 100644 index b01b6523..00000000 --- a/skills/using-superpowers/references/gemini-tools.md +++ /dev/null @@ -1,63 +0,0 @@ -# Gemini CLI Tool Mapping - -Skills speak in actions ("dispatch a subagent", "create a todo", "read a file"). On Gemini CLI these resolve to the tools below. - -| Action skills request | Gemini CLI equivalent | -|----------------------|----------------------| -| Read a file | `read_file` | -| Read multiple files at once | `read_many_files` | -| Create a new file | `write_file` | -| Edit a file | `replace` | -| Run a shell command | `run_shell_command` | -| Search file contents | `grep_search` | -| Find files by name | `glob` | -| List files and subdirectories | `list_directory` | -| Fetch a URL | `web_fetch` | -| Search the web | `google_web_search` | -| Invoke a skill | `activate_skill` | -| Dispatch a subagent (`Subagent (general-purpose):` template) | `invoke_agent` with `agent_name: "generalist"` (invocable via `@generalist` chat syntax — see [Subagent support](#subagent-support)) | -| Multiple parallel dispatches | Multiple `invoke_agent` calls in the same response | -| Task tracking ("create a todo", "mark complete") | `write_todos` (statuses: pending, in_progress, completed, cancelled, blocked) | - -## Instructions file - -When a skill mentions "your instructions file", on Gemini CLI this is **`GEMINI.md`**. Gemini CLI loads `GEMINI.md` hierarchically: global at `~/.gemini/GEMINI.md`, project-level files in workspace directories and their ancestors, and sub-directory `GEMINI.md` files when a tool accesses files in those directories. - -## Personal skills directory - -User-level skills live at **`~/.gemini/skills/`**, with **`~/.agents/skills/`** as a cross-runtime alias (shared with Codex and Copilot CLI). When both directories exist at the same scope, `.agents/skills/` takes precedence. Each skill is a subdirectory containing a `SKILL.md` (with `name` and `description` frontmatter). - -## Subagent support - -Gemini CLI dispatches subagents through the `invoke_agent` tool, which takes `agent_name` and `prompt` parameters. The same dispatch is also surfaced as a chat-syntax shortcut: typing `@generalist ` is equivalent to calling `invoke_agent` with `agent_name: "generalist"`. Built-in agent names include `generalist`, `cli_help`, `codebase_investigator`, and (with browser tooling enabled) `browser_agent`. - -Skills dispatch with `Subagent (general-purpose):` and either reference a prompt-template file (e.g., `superpowers:subagent-driven-development`'s `./implementer-prompt.md`) or supply an inline prompt. On Gemini CLI: - -| Skill dispatch form | Gemini CLI equivalent | -|---------------------|----------------------| -| References a `*-prompt.md` template (implementer, task-reviewer, code-reviewer, etc.) | Fill the template, then `invoke_agent` with `agent_name: "generalist"` and the filled prompt | -| References `superpowers:requesting-code-review`'s `./code-reviewer.md` | `invoke_agent` with `agent_name: "generalist"` and the filled review template | -| Inline prompt (no template referenced) | `invoke_agent` with `agent_name: "generalist"` and your inline prompt | - -### Prompt filling - -Skills provide prompt templates with placeholders like `{WHAT_WAS_IMPLEMENTED}` or `[FULL TEXT of task]`. Fill all placeholders before passing the complete prompt to `invoke_agent`. The prompt template itself contains the agent's role, review criteria, and expected output format — the subagent will follow it. - -### Parallel dispatch - -Gemini CLI supports parallel subagent dispatch. Issue multiple `invoke_agent` calls in the same response (or multiple `@generalist` invocations in one prompt) to run independent subagent work in parallel. Keep dependent tasks sequential, but do not serialize independent subagent tasks just to preserve a simpler history. - -## Additional Gemini CLI tools - -These tools are unique to Gemini CLI: - -| Tool | Purpose | -|------|---------| -| `save_memory` (legacy) | Persist facts across sessions when `experimental.memoryV2 = false` | -| `get_internal_docs` | Look up Gemini CLI's bundled documentation | -| `ask_user` | Pose structured questions to the user (text / single-select / multi-select) | -| `enter_plan_mode` / `exit_plan_mode` | Switch into and out of read-only plan mode | -| `update_topic` | Update the current conversation's topic / strategic-intent metadata | -| `complete_task` | Signal that a Gemini subagent has completed and return its result to the parent agent | -| `tracker_create_task`, `tracker_update_task`, `tracker_get_task`, `tracker_list_tasks`, `tracker_add_dependency`, `tracker_visualize` | Rich task tracker with dependency and visualization support | -| `read_mcp_resource`, `list_mcp_resources` | MCP resource access | diff --git a/skills/writing-skills/SKILL.md b/skills/writing-skills/SKILL.md index 8928d449..6d3ded6e 100644 --- a/skills/writing-skills/SKILL.md +++ b/skills/writing-skills/SKILL.md @@ -9,7 +9,7 @@ description: Use when creating new skills, editing existing skills, or verifying **Writing skills IS Test-Driven Development applied to process documentation.** -**Personal skills live in your runtime's skills directory** — see [claude-code-tools.md](../using-superpowers/references/claude-code-tools.md), [codex-tools.md](../using-superpowers/references/codex-tools.md), [copilot-tools.md](../using-superpowers/references/copilot-tools.md), or [gemini-tools.md](../using-superpowers/references/gemini-tools.md) for the path on your runtime. Codex, Copilot CLI, and Gemini CLI all also recognize `~/.agents/skills/` as a cross-runtime alias. +**Personal skills live in your runtime's skills directory** You write test cases (pressure scenarios with subagents), watch them fail (baseline behavior), write the skill (documentation), watch tests pass (agents comply), and refactor (close loopholes).