pitroom 0.10.0 → 0.11.0

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "pitroom",
   "description": "A free pit crew for your expensive coding agent: the superpowers development workflow, run by cheap workers. Delegate research, fixes, tests, reviews and whole plans from Claude Code, Codex or any agent to OpenCode, Codex or Claude Code workers, with receipts that prove the savings.",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "author": {
     "name": "TahaAtas"
   },
@@ -18,5 +18,6 @@
     "subagents",
     "tokens",
     "workers"
-  ]
+  ],
+  "hooks": "./hooks/claude-hooks.json"
 }

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "pitroom",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "A free pit crew for your expensive coding agent: delegate research, fixes, tests, reviews and parallel investigations to cheap worker agents running your own models, with verified answers, exact diffs and cost receipts.",
   "author": {
     "name": "TahaAtas"

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 0.11.0
+
+### Gemini CLI as your primary agent
+- Pitroom installs into Gemini CLI as an extension: `gemini extensions install https://github.com/ATASTECH/pitroom` gives it the 14 skills and a short context file that introduces Pitroom (`gemini-extension.json`, `gemini-context.md`). Gemini CLI also still works as a worker (`-W gemini`); the two are separate. Gemini asks you to confirm the extension. Its session-start hook text did not reach a Gemini session in a test (Gemini probably runs extension hooks only once you trust them), so the context file is what introduces Pitroom there.
+- `hooks/hooks.json` is now valid for both Claude Code and Gemini CLI (a Gemini extension reads that file too and warned about Claude Code's `PostToolUse` event on every session): it holds SessionStart only, with a command that fills `${CLAUDE_PLUGIN_ROOT}` in Claude Code and `${extensionPath}` in Gemini CLI. The card after each `pitroom` command is Claude Code's alone and moved to `hooks/claude-hooks.json`, named by `hooks` in the Claude plugin manifest. `npm run bump` and the release test keep `gemini-extension.json` in step with the version.
+
+### Doctor
+- Worker CLIs that are installed but not in your config now get a section ("Gemini CLI (installed, not in your config)") with how to use them, so a new worker is not invisible. They never count as warnings, and a CLI that is not installed stays out of the way.
+- A Gemini API key that Gemini CLI keeps itself is no longer reported as "not signed in".
+- Doctor warns when Pitroom is a Gemini extension and its skills are also linked into `~/.agents/skills`: Gemini would load them twice.
+
+### Docs
+- The README has a Gemini CLI install block and a row in the install table.
+
+## 0.10.1
+
+### Docs
+- The README names Gemini CLI in the quick start (with the API-key requirement), the features, the examples and `pitroom models`; the Gemini star joins Claude and Codex in the hero image. The skills and the marketplace text list Gemini CLI too. The npm page shows the README of the published package, so this is where it reaches it.
+
 ## 0.10.0
 
 ### Audits

package/README.md

@@ -31,7 +31,7 @@ Model-agnostic · Verified answers · Receipts, not vibes · OpenCode / Codex /
 
 <br />
 
-<img src="docs/pitroom-hero.png" alt="Pitroom — a free pit crew for your expensive coding agent. Orange Claw’d and a blue terminal-faced Codex pet work together at a coding terminal." width="94%" />
+<img src="docs/pitroom-hero.png" alt="Pitroom — a free pit crew for your expensive coding agent. Orange Claw’d, a blue terminal-faced Codex pet and a purple-blue Gemini star work together at a coding terminal." width="94%" />
 
 <br />
 
@@ -260,7 +260,14 @@ codex plugin add pitroom@pitroom
 npm i -g pitroom
 ```
 
-**Any other agent (Cursor, Gemini CLI, a plain shell) or just the CLI**
+**Gemini CLI**
+
+```bash
+gemini extensions install https://github.com/ATASTECH/pitroom
+npm i -g pitroom
+```
+
+**Any other agent (Cursor, a plain shell) or just the CLI**
 
 ```bash
 npm i -g pitroom
@@ -270,6 +277,7 @@ pitroom install
 | Path | You get |
 |---|---|
 | Claude Code plugin | The 14 skills, the session-start hook that introduces Pitroom, and a card after each `pitroom` command. |
+| Gemini CLI extension | The 14 skills and a short context file that introduces Pitroom (Gemini asks you to confirm the extension). Gemini CLI also works as a *worker*, which is separate: see [Workers](#workers). |
 | Codex plugin | The 14 skills, a session-start hook that introduces Pitroom (so it is known even when Codex drops skill descriptions because many are installed), and a card after each `pitroom` command. Codex asks you to trust the plugin's hooks once. The hooks call `pitroom`, which comes from npm (`npm i -g pitroom`). |
 | npm + `pitroom install` | The CLI, and the skills linked into `~/.agents/skills` and `~/.claude/skills`. |
 

package/dist/lib.mjs

@@ -774,6 +774,8 @@ function doctor3({ models, hasFallback }) {
   const type = settings().security?.auth?.selectedType;
   if (key || vertex) {
     checks.push({ level: "ok", message: `Gemini CLI: ${key ? "an API key is set" : "Vertex AI is set up"}` });
+  } else if (type === "gemini-api-key" || type === "vertex-ai") {
+    checks.push({ level: "ok", message: `Gemini CLI: ${type === "vertex-ai" ? "Vertex AI" : "an API key"} is selected (kept by Gemini CLI)` });
   } else if (signedIn && type === "oauth-personal") {
     checks.push({
       level: "warn",

package/dist/pitroom.mjs

@@ -874,6 +874,8 @@ function doctor3({ models, hasFallback }) {
   const type = settings().security?.auth?.selectedType;
   if (key || vertex) {
     checks.push({ level: "ok", message: `Gemini CLI: ${key ? "an API key is set" : "Vertex AI is set up"}` });
+  } else if (type === "gemini-api-key" || type === "vertex-ai") {
+    checks.push({ level: "ok", message: `Gemini CLI: ${type === "vertex-ai" ? "Vertex AI" : "an API key"} is selected (kept by Gemini CLI)` });
   } else if (signedIn && type === "oauth-personal") {
     checks.push({
       level: "warn",
@@ -4353,7 +4355,7 @@ function secretWarning(files, mode) {
 }
 
 // src/core/run.ts
-var VERSION2 = true ? "0.10.0" : "0.0.0-dev";
+var VERSION2 = true ? "0.11.0" : "0.0.0-dev";
 function planWork(o) {
   if (!o.plan) return { task: o.task.trim(), tier: o.tier };
   if (o.continueFrom) throw new UserError("a follow-up continues its parent's task; drop --plan/--step");
@@ -5289,6 +5291,19 @@ function doctor5(probe) {
     addAll(backend.doctor({ models: [...new Set(models)], hasFallback: chain.length > 1 }));
     add("ok", `${backend.name}: read-only runs enforced by ${READ_ONLY_HOW[backend.capabilities.readOnly]}`);
   }
+  const unused = allBackends().filter((b) => !byBackend.has(b.id));
+  for (const backend of unused) {
+    let found;
+    try {
+      found = backend.doctor({ models: [], hasFallback: true });
+    } catch {
+      continue;
+    }
+    if (!found.length || found[0].level === "fail") continue;
+    section2(`${backend.name} (installed, not in your config)`);
+    for (const c of found) add("ok", c.message);
+    add("ok", `use it with -W ${backend.id}[:model], or name it in "fallback" or "tiers" in the config`);
+  }
   section2("Skills and agents");
   addAll(skillChecks());
   if (probe && chain[0]) {
@@ -5364,6 +5379,12 @@ function skillChecks() {
     else if (names.length) checks.push({ level: "warn", message: `skills in ${base2}: only ${names.join(", ")} of ${all.length}; run \`pitroom install\`` });
     else if (!viaPlugin) checks.push({ level: "warn", message: `no Pitroom skills in ${base2}; run \`pitroom install\`` });
   }
+  if (geminiExtensionInstalled()) {
+    const linked = installedSkills().some((i) => i.base.includes(`${path24.sep}.agents${path24.sep}`) && i.names.length);
+    checks.push(
+      linked ? { level: "warn", message: "Pitroom is installed as a Gemini CLI extension and linked into ~/.agents/skills: Gemini loads the skills twice; run `pitroom uninstall` or `gemini extensions uninstall pitroom`" } : { level: "ok", message: "Gemini CLI extension installed (skills + context)" }
+    );
+  }
   if (viaPlugin) {
     const linked = installedSkills().some((i) => i.base.includes(`${path24.sep}.claude${path24.sep}`) && i.names.length);
     checks.push(
@@ -5381,6 +5402,10 @@ function skillChecks() {
   }
   return checks;
 }
+function geminiExtensionInstalled() {
+  const home2 = process.env.GEMINI_CLI_HOME ?? os10.homedir();
+  return fs28.existsSync(path24.join(home2, ".gemini", "extensions", "pitroom"));
+}
 function pluginInstalled() {
   try {
     const f = path24.join(os10.homedir(), ".claude", "plugins", "installed_plugins.json");

package/gemini-context.md

@@ -0,0 +1,5 @@
+# Pitroom
+
+Pitroom is installed: you can hand bounded work (research, fixes in an isolated copy, tests, reviews) to cheaper worker agents and get back a verified answer, the exact diff and a receipt. You decide, verify and answer.
+
+Start with the `using-pitroom` skill (a menu of the `pitroom-*` skills and when each pays off). The CLI is `pitroom` (`npm i -g pitroom`; `pitroom doctor` checks the setup). Use it when it helps; for a small task you can do yourself, skip it.

package/gemini-extension.json

@@ -0,0 +1,6 @@
+{
+  "name": "pitroom",
+  "version": "0.11.0",
+  "description": "A free pit crew for your expensive coding agent: hand reading, fixes, tests and reviews to cheap worker agents and get back the answer, the exact diff and a receipt. Fourteen skills adapt a full development workflow. Needs the pitroom command (npm i -g pitroom).",
+  "contextFileName": "gemini-context.md"
+}

package/hooks/claude-hooks.json

@@ -0,0 +1,16 @@
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/dist/pitroom.mjs\" hook-card",
+            "timeout": 10
+          }
+        ]
+      }
+    ]
+  }
+}

package/hooks/hooks.json

@@ -6,23 +6,11 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/session-start.mjs\"",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}${extensionPath}/hooks/session-start.mjs\"",
             "async": false
           }
         ]
       }
-    ],
-    "PostToolUse": [
-      {
-        "matcher": "Bash",
-        "hooks": [
-          {
-            "type": "command",
-            "command": "node \"${CLAUDE_PLUGIN_ROOT}/dist/pitroom.mjs\" hook-card",
-            "timeout": 10
-          }
-        ]
-      }
     ]
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pitroom",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "A free pit crew for your expensive coding agent: the superpowers development workflow, run by cheap workers. Delegate research, fixes, tests, reviews and whole plans from Claude Code, Codex or any agent to OpenCode, Codex, Claude Code or Gemini CLI workers, with receipts that prove the savings.",
   "type": "module",
   "author": "TahaAtas",
@@ -23,6 +23,8 @@
     "policies",
     ".claude-plugin",
     ".codex-plugin",
+    "gemini-extension.json",
+    "gemini-context.md",
     "assets",
     "docs/backends.md",
     "README.md",