pitroom 0.13.0 → 0.14.1

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

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "pitroom",
-  "version": "0.13.0",
+  "version": "0.14.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,20 @@
 # Changelog
 
+## 0.14.1
+
+### Docs
+- The dashboard images and the GIF show audits (an `audited · agrees / disagrees` badge, the audit run's own card, the disputed claims on an opened card) and a worker skipped because its quota ran out ("Skipped … cooling down until 14:05"); the Stats image has the new Audited column (confirmed / audited per worker). The README's Dashboard section explains them. The npm page shows the README of the published package, so this is where it reaches it.
+
+## 0.14.0
+
+### MCP server
+- `pitroom mcp` serves Pitroom as a [Model Context Protocol](https://modelcontextprotocol.io) server on stdio, so any agent that speaks MCP (Cursor, Claude Desktop, Claude Code, Codex, Gemini CLI, …) can use it as tools instead of shell commands and skills: `pitroom_run` (read, isolate or write), `pitroom_wait`, `pitroom_status`, `pitroom_show`, `pitroom_review`, `pitroom_audit`, `pitroom_apply`, `pitroom_discard` and `pitroom_stop`, each with a JSON schema and hints (`apply` is marked destructive). Set it up with `claude mcp add pitroom -- pitroom mcp`, `codex mcp add pitroom -- pitroom mcp`, `gemini mcp add pitroom pitroom mcp`, or an `mcpServers` entry for Cursor and Claude Desktop (see the README).
+- Each tool runs the matching `pitroom` command, so every rule of the CLI applies unchanged (permission profiles, git guard, isolation, read snapshots, cooldowns, audits) and the tools cannot drift from the CLI. A run is waited for up to `waitSeconds` (default 50, at most 540), then comes back as "still running" with its id for `pitroom_wait`. No new dependency: a small JSON-RPC implementation (protocol versions 2025-06-18, 2025-03-26 and 2024-11-05, batches, the standard error codes); only JSON reaches stdout.
+- Tested against the protocol with a real server process, and with a real client: Gemini CLI connected, called `pitroom_run` for a question, got the worker's answer with its references verified and collected an audit. Limits: stdio only, no MCP resources, prompts or progress notifications yet (the agent polls with `pitroom_wait`).
+
+### Fixes
+- `pitroom stop` on a run whose process is still starting: the process has no signal handler yet and died on the signal, and the run showed "failed: worker process exited unexpectedly". `stop` now says first that a stop was asked for, and such a run is "stopped". This was the cause of a flaky test (`stop -g …`).
+
 ## 0.13.0
 
 ### Read snapshots

package/README.md

@@ -162,9 +162,13 @@ The screenshots below show sample data (an imaginary `shop-api` project), not a
 
 <p align="center"><img src="docs/dash-card.png" width="100%" alt="An expanded run card: the task, a ten-step activity list, the result, five changed files with one opened to its highlighted diff, and the details"></p>
 
+**Audits and skipped workers show on the card.** A research answer that another worker re-checked ([Audits](#audits)) carries an `audited · agrees / partly agrees / disagrees` badge and, when it disagrees, the claims it disputes; a worker left out because its quota ran out is listed under the details ("Skipped … cooling down until 14:05", see `pitroom cooldown`).
+
+<p align="center"><img src="docs/dash-audit.png" width="100%" alt="An expanded research card whose answer was audited by another worker, which disagrees and lists two disputed claims with file:line, and a note that a worker was skipped because its daily quota was used up"></p>
+
 **History** searches everything Pitroom ever ran (the full text of tasks, answers and steps), with filters by state, model and period; each run opens as the same card as on Live. **Stats** shows runs, success rate, time, tokens and savings, per worker and model and per day.
 
-<p align="center"><img src="docs/dash-history.png" width="49%" alt="The History tab: a search box, filters and every past run as a card"> <img src="docs/dash-stats.png" width="49%" alt="The Stats tab: totals, runs per day and success rate per worker and model, each with its logo"></p>
+<p align="center"><img src="docs/dash-history.png" width="49%" alt="The History tab: a search box, filters and every past run as a card"> <img src="docs/dash-stats.png" width="49%" alt="The Stats tab: totals, runs per day, and per worker and model its logo, success rate and how many of its audited answers another worker confirmed"></p>
 
 The dashboard is a React app built once into `dist/ui` and served as two static files, so the CLI still has no runtime dependencies. It follows your system's light or dark theme (a button switches it).
 
@@ -267,7 +271,25 @@ gemini extensions install https://github.com/ATASTECH/pitroom
 npm i -g pitroom
 ```
 
-**Any other agent (Cursor, a plain shell) or just the CLI**
+**Any agent that speaks MCP (Cursor, Claude Desktop, and the three above too)**
+
+Pitroom is also an [MCP](https://modelcontextprotocol.io) server on stdio: nine tools (`pitroom_run`, `pitroom_wait`, `pitroom_status`, `pitroom_show`, `pitroom_review`, `pitroom_audit`, `pitroom_apply`, `pitroom_discard`, `pitroom_stop`) instead of shell commands and skills. After `npm i -g pitroom`:
+
+```bash
+claude mcp add pitroom -- pitroom mcp
+codex mcp add pitroom -- pitroom mcp
+gemini mcp add pitroom pitroom mcp
+```
+
+or, for Cursor (`~/.cursor/mcp.json`), Claude Desktop (`claude_desktop_config.json`) and others:
+
+```json
+{ "mcpServers": { "pitroom": { "command": "pitroom", "args": ["mcp"] } } }
+```
+
+Each tool runs the matching `pitroom` command, so every rule of the CLI applies unchanged (permission profiles, git guard, isolation, read snapshots). A run is waited for up to `waitSeconds` (default 50), then comes back as "still running" with its id for `pitroom_wait`; keep it below your client's tool timeout. The server works in the directory the client starts it in.
+
+**Any other agent (a plain shell) or just the CLI**
 
 ```bash
 npm i -g pitroom
@@ -278,6 +300,7 @@ pitroom install
 |---|---|
 | 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). |
+| MCP server | The nine tools above, for any agent that can use MCP servers. No skills: the tools describe themselves, and the server tells the agent how to start. |
 | 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`. |
 
@@ -459,6 +482,7 @@ pitroom crew [-i] [-g NAME] "task 1" "task 2" …   (or --task-file with --- sep
 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 mcp                  # serve Pitroom as MCP tools on stdio
 pitroom cooldown [--clear]
 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