pitroom 0.9.0 → 0.10.1

package/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
   "plugins": [
     {
       "name": "pitroom",
-      "description": "Delegate research, fixes, tests and parallel investigations to cheap OpenCode, Codex or Claude Code workers, with verified answers, exact diffs and cost receipts.",
+      "description": "Delegate research, fixes, tests and parallel investigations to cheap OpenCode, Codex, Claude Code or Gemini CLI workers, with verified answers, exact diffs and cost receipts.",
       "source": {
         "source": "npm",
         "package": "pitroom"

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.9.0",
+  "version": "0.10.1",
   "author": {
     "name": "TahaAtas"
   },

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "pitroom",
-  "version": "0.9.0",
+  "version": "0.10.1",
   "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,22 @@
 # Changelog
 
+## 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
+- A finished read run's answer can be re-checked in the background by another worker, which verifies the key claims against your project and replies `AGREE`, `PARTIAL` or `DISAGREE` with the claims it disputes. Pitroom already checked that every cited `path:line` exists; an audit checks that what is said about it is true.
+- Ways to use it: `pitroom audit RUN [-W worker]` now; `pitroom run --audit` / `--no-audit` per run; `"audit": 0.1` in the config (or `PITROOM_AUDIT=0.1`) for about one read run in ten, chosen by a stable hash of the run id. The auditor is the `audit` tier, else `cheap`.
+- **Off by default.** An audit costs about the rate times the answer's own tokens, runs detached after the run and never delays or fails it. The auditor is never the worker and model that gave the answer, and does not fall back to it; with no other worker nothing starts and `pitroom doctor` says so. Only read runs are audited, never reviews, changes or other audits.
+- The verdict and the disputed claims are on the audited run (`pitroom show`, the dashboard card with an `audited · agrees/disagrees` badge and a note, History), and Stats has an Audited column per worker (confirmed/audited). Audits are not counted as runs and are not in the savings ledger.
+- An audit is a sample, not a guarantee: the auditor is a model too and can share a blind spot.
+
+### Tests
+- Test cleanup retries when a background process (Chrome, a dash server, an audit) is still writing as a test directory is removed (an `ENOTEMPTY` flake seen on CI).
+
 ## 0.9.0
 
 ### Gemini CLI worker (beta)

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 />
 
@@ -107,7 +107,7 @@ In isolate mode nothing reaches your tree until you apply it.
 - **Self-healing worker chain.** Free models get rate-limited or retired. List fallback workers once (`fallback`) and a run that hits "model not found", 429 or quota errors moves to the next model automatically. Still no model hardcoded: the chain is yours.
 - **A crew, not just one worker.** `pitroom crew` starts several workers at once, `pitroom watch --json` streams one line per change so your agent follows them live, `pitroom wait -g` collects every answer, `pitroom apply -g` lands isolated patches in order. Up to 20 workers run at once by default (`maxParallel`, 30 at most), the rest queue, and the fallback chain absorbs free-tier rate limits; parallel writers are refused.
 - **Faster, not only cheaper.** Workers run in the background and side by side (up to 20 at once) while your agent keeps working, so slow reading and review stop blocking it. In the [benchmark](#benchmarks), 470 s of worker time finished in 156 s of wall clock, about 3× faster than one question after another, and your agent's own context stayed small.
-- **Free first, dearer only when needed.** Runs and plan tasks start on the `cheap` tier, OpenCode's free model; `standard` (Codex) and `capable` (Claude Code) are for tasks that need them, and an optional `review` tier names who reviews. `pitroom models` shows what each worker offers, the effort levels (`low` … `xhigh`) each model accepts, what you say it costs (`costs`) and what it used; `--effort` sets the level per run. Details: [Models, costs and effort](#models-costs-and-effort).
+- **Free first, dearer only when needed.** Runs and plan tasks start on the `cheap` tier, OpenCode's free model; `standard` (Codex) and `capable` (Claude Code) are for tasks that need them, and an optional `review` tier names who reviews. Gemini CLI with a free Google AI Studio key is one more cheap worker (small daily quota per model). `pitroom models` shows what each worker offers, the effort levels (`low` … `xhigh`) each model accepts, what you say it costs (`costs`) and what it used; `--effort` sets the level per run. Details: [Models, costs and effort](#models-costs-and-effort).
 - **Exact changes, even in a dirty tree.** Pitroom snapshots the working tree with a throwaway git index (your index, branches and stash are never touched), so it reports *only the worker's* edits and can undo exactly those: `pitroom revert <id>`.
 - **Your agent sets the permissions.** It creates each worker with the permissions the task and your session allow (read-only, isolated copy, in-place edits, web), and a worker never widens its own. A fixed floor stays for every run: no git history changes, no `sudo`, no publishing, no secrets. A worker cannot land a deletion either: `pitroom apply` refuses a patch that deletes files unless your agent passes `--allow-delete`.
 - **Real isolation.** `--isolate` runs the worker in a private copy of your **current** state (its own repository, sharing your objects read-only), uncommitted and untracked files included, then hands you a patch: `pitroom apply <id>` (checked, refuses on conflict) or `pitroom discard <id>`.
@@ -239,7 +239,7 @@ To repeat it on your own repository: `pitroom crew -d <repo> -g bench "<question
 
 ## Quick start
 
-You need Node.js 22.13+ and at least one worker CLI: [OpenCode](https://opencode.ai) v2+ (the default worker, with free models), [Codex CLI](https://github.com/openai/codex) or [Claude Code](https://claude.com/claude-code).
+You need Node.js 22.13+ and at least one worker CLI: [OpenCode](https://opencode.ai) v2+ (the default worker, with free models), [Codex CLI](https://github.com/openai/codex), [Claude Code](https://claude.com/claude-code) or [Gemini CLI](https://github.com/google-gemini/gemini-cli) (beta; it needs an API key from [Google AI Studio](https://aistudio.google.com/apikey), a Google account sign-in no longer works for it).
 
 ### 1. Install: pick your agent
 
@@ -294,6 +294,7 @@ Or start a worker yourself and read its receipt:
 
 ```bash
 pitroom "Which files read the session cookie? Cite file:line."
+pitroom -W gemini:gemini-3.8-flash "…"   # the same on another worker (see Workers below)
 pitroom savings          # what all your runs saved so far
 pitroom models           # what each worker offers, what it costs you, what it used
 ```
@@ -359,6 +360,22 @@ Tiers map plan tasks to workers: `"tiers": {"cheap": "opencode", "standard": "co
 
 ---
 
+## Audits
+
+Pitroom checks every `path:line` a worker cites, which proves a line exists, not that the claim about it is true. An **audit** asks a second worker to verify an answer's key claims against your project and to say `AGREE`, `PARTIAL` or `DISAGREE`, with the claims it disputes.
+
+```bash
+pitroom audit <run>            # now: re-check one read run (-W picks the auditor)
+pitroom run --audit "…"        # re-check this run's answer when it finishes (--no-audit skips it)
+```
+
+or set `"audit": 0.1` in the config (or `PITROOM_AUDIT=0.1`) to have about one read run in ten audited, in the background, without your agent asking. The same run is always in or out of the sample.
+
+- **Cost:** off by default. An audit is a read run of the auditor, so about the rate times the worker's own tokens, on the `audit` tier (else `cheap`, i.e. a free model if that is your cheap tier). It never delays the run or fails it.
+- **Never itself:** the auditor is never the worker and model that gave the answer; with no other worker configured nothing is audited (`pitroom doctor` says so). Only read runs are audited: a change has `pitroom review`.
+- **Where it shows:** the answer's card and `pitroom show` carry the verdict and the disputed claims; the Stats tab counts, per worker, how many audited answers were confirmed. Audits are not counted as runs and save nothing.
+- **A sample, not a guarantee.** The auditor is a model too: it can share a blind spot, and a few audits say little about a worker. Treat `DISAGREE` as a reason to look, and `AGREE` as one more signal.
+
 ## Crews
 
 A real crew over this repository, four questions at once on a free OpenCode Zen model:
@@ -431,6 +448,7 @@ pitroom run --continue <run|last> "follow-up"
 pitroom crew [-i] [-g NAME] "task 1" "task 2" …   (or --task-file with --- separators)
 pitroom run -i --plan PLAN --step N [--tier T] ["notes"]
 pitroom review [run | --range A..B [--plan PLAN]] [--tier T | -W T] [--bg]
+pitroom audit RUN [-W worker]
 pitroom plan status PLAN [--json] · pitroom plan note PLAN "Task N: …"
 pitroom status|wait|watch [run… | -g NAME]        wait: --any --brief --timeout · watch: --json|--brief --interval
 pitroom dash [--detach] [--port N] [--open] [--stop]   a live page of the runs on 127.0.0.1
@@ -502,8 +520,9 @@ A worker is named by a target: `backend[:model]`.
 pitroom run "…"                                          # preferred worker (config "worker", default opencode)
 pitroom run -W opencode:opencode/space-bunny-free "…"    # a specific backend and model
 pitroom run -W 'codex:#low' "…"                          # the model from config "models" (not Codex's default), low reasoning effort
-pitroom run --effort high "…"                           # any worker: model#level (Codex, Claude Code, OpenCode)
+pitroom run --effort high "…"                           # model#level (Codex, Claude Code, OpenCode; Gemini CLI has no effort option)
 pitroom run -W claude:haiku "…"                          # Claude Code on a cheap model
+pitroom run -W gemini:gemini-3.8-flash "…"               # Gemini CLI (beta; needs a Google AI Studio API key)
 pitroom run -m nvidia/z-ai/glm-5.3 "…"                   # another model on the preferred worker
 ```
 
@@ -516,7 +535,7 @@ pitroom run -m nvidia/z-ai/glm-5.3 "…"                   # another model on th
 
 ### Models, costs and effort
 
-`pitroom models` lists what each worker offers (Codex from its own model cache, Claude Code's aliases, OpenCode's `opencode models`), the reasoning-effort levels each model accepts, what you say it costs and what your own runs used:
+`pitroom models` lists what each worker offers (Codex from its own model cache, Claude Code's aliases, OpenCode's `opencode models`, Gemini CLI's built-in names), the reasoning-effort levels each model accepts, what you say it costs and what your own runs used:
 
 ```text
 worker  model        effort (* default)                 cost  runs  avg tokens  $/run   in use
@@ -563,12 +582,14 @@ Or put defaults in `~/.config/pitroom/config.json` (flags and env still win); `p
   "timeout": "20m",
   "primary": "opus",
   "link": ["node_modules"],
-  "maxParallel": 20
+  "maxParallel": 20,
+  "audit": 0.1
 }
 ```
 
 - `worker` and `fallback`: who runs a task when you name no one, and who takes over when it fails; `models`: the model each worker uses when a target names none.
 - `tiers`: `cheap`, `standard` and `capable` name the workers for plan tasks and `--tier`; an optional `review` tier names who reviews a run (by default another worker than the implementer's, `standard` first).
+- `audit`: the chance (0 to 1, default 0 = off) that a finished read run is re-checked in the background, see [Audits](#audits). The `audit` tier (else `cheap`) names who does it.
 - `costs`: your relative cost per `worker:model`, only compared with each other; `maxParallel`: workers at once (default 20, at most 30).
 
 

package/dist/lib.mjs

@@ -1512,6 +1512,13 @@ function parseVerdict(text) {
     minor: count("minor")
   };
 }
+function parseAudit(text) {
+  const word = /^\s*AUDIT:\s*(AGREE|PARTIAL|DISAGREE)\b/im.exec(text)?.[1]?.toLowerCase();
+  const verdict = word === "agree" || word === "partial" || word === "disagree" ? word : "unclear";
+  const after = /^\s*DISPUTED:\s*$/im.exec(text);
+  const disputed = after ? text.slice(after.index + after[0].length).split("\n").map((l) => l.trim()).filter((l) => /^[-*•]\s+\S/.test(l)).map((l) => l.replace(/^[-*•]\s+/, "")).filter((l) => !/^\(?none\)?\.?$/i.test(l)).slice(0, 8) : [];
+  return { verdict, disputed };
+}
 
 // src/core/plan.ts
 import fs8 from "node:fs";
@@ -1596,6 +1603,7 @@ export {
   getBackend,
   loadPlan,
   loadTemplate,
+  parseAudit,
   parsePlan,
   parseStatus,
   parseTarget,