pitroom 0.6.0 → 0.6.1

package/.claude-plugin/marketplace.json

@@ -8,8 +8,10 @@
     {
       "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.",
-      "version": "0.6.0",
-      "source": "./",
+      "source": {
+        "source": "npm",
+        "package": "pitroom"
+      },
       "author": {
         "name": "TahaAtas"
       }

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

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "pitroom",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "A free pit crew for your expensive coding agent: delegate research, fixes, tests and parallel investigations to cheap OpenCode, Codex or Claude Code workers, with verified answers, exact diffs and cost receipts.",
   "author": {
     "name": "TahaAtas"
@@ -19,11 +19,17 @@
     "workers"
   ],
   "skills": "./skills/",
-  "hooks": {},
   "interface": {
     "displayName": "Pitroom",
-    "shortDescription": "Cheap OpenCode, Codex or Claude Code workers for research, fixes and parallel tasks",
-    "longDescription": "Pitroom lets the primary agent hand bounded work to OpenCode, Codex or Claude Code workers running the user's own free, paid or local models: read-only research, isolated code changes, second-opinion reviews and parallel crews, with per-run permission profiles, a git guard, verified file references, exact diffs and cost receipts.",
-    "category": "Developer Tools"
+    "shortDescription": "Cheap workers for your agent",
+    "longDescription": "Pitroom lets your coding agent hand bounded work to OpenCode, Codex or Claude Code workers running your own free, paid or local models: read-only research, isolated code changes, second-opinion reviews and parallel crews, with per-run permission profiles, a git guard, verified file references, exact diffs and cost receipts. Fourteen skills adapt a full development workflow (brainstorm, plan, worker-driven development, review, debugging, TDD, verification). Requires the pitroom command (npm i -g pitroom), Node.js 18 or newer and at least one worker CLI.",
+    "developerName": "TahaAtas",
+    "category": "Developer Tools",
+    "capabilities": [
+      "Read",
+      "Write"
+    ],
+    "websiteURL": "https://github.com/ATASTECH/pitroom",
+    "supportURL": "https://github.com/ATASTECH/pitroom/issues"
   }
 }

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.6.1
+
+### Install
+- The Claude Code and Codex marketplace now installs the published npm package (under 0.5 MB, no dependencies) instead of copying the whole repository: before, `claude plugin install` also copied `src/` and `test/` and ran `npm install` for the development tools (39 MB). One `.claude-plugin/marketplace.json` serves both agents.
+- The README has an install table per agent: Claude Code plugin, Codex plugin (skills only, no session-start hook, the `pitroom` command comes from npm) and npm with `pitroom install`.
+
+### Directory listing
+- The Codex manifest carries the listing fields the public plugin directory asks for (short description, developer, capabilities, links) and no longer declares `hooks`, which the directory does not accept.
+- `docs/releasing.md` lists the release steps and how to submit to the Anthropic and OpenAI directories.
+
 ## 0.6.0
 
 ### Workflow skills

package/README.md

@@ -12,6 +12,7 @@ Model-agnostic · Verified answers · Receipts, not vibes · OpenCode / Codex /
 
 [![Release](https://img.shields.io/github/v/release/ATASTECH/pitroom?label=release)](https://github.com/ATASTECH/pitroom/releases/latest)
 [![Downloads](https://img.shields.io/github/downloads/ATASTECH/pitroom/total?label=downloads)](https://github.com/ATASTECH/pitroom/releases)
+[![npm](https://img.shields.io/npm/v/pitroom?label=npm)](https://www.npmjs.com/package/pitroom)
 [![Stars](https://img.shields.io/github/stars/ATASTECH/pitroom?style=flat&label=stars)](https://github.com/ATASTECH/pitroom/stargazers)
 [![CI](https://github.com/ATASTECH/pitroom/actions/workflows/ci.yml/badge.svg)](https://github.com/ATASTECH/pitroom/actions/workflows/ci.yml)
 [![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
@@ -145,9 +146,9 @@ Every run prints a receipt, and `pitroom savings` adds them up:
 
 ### 01
 
-**Get it**
+**Install**
 
-Clone the repository
+Plugin or npm (below)
 
 </td>
 
@@ -155,9 +156,9 @@ Clone the repository
 
 ### 02
 
-**Link it**
+**Connect a worker**
 
-`pitroom install`
+OpenCode, Codex or Claude Code
 
 </td>
 
@@ -186,24 +187,34 @@ Ask your agent, or run `pitroom`
 
 Requires Node.js 18+ and at least one worker CLI: [OpenCode](https://opencode.ai) v2+ (the default worker), [Codex CLI](https://github.com/openai/codex) or [Claude Code](https://claude.com/claude-code).
 
+### Choose how to install
+
+| You use | Install | What you get |
+|---|---|---|
+| **Claude Code** | `claude plugin marketplace add ATASTECH/pitroom`<br>`claude plugin install pitroom@pitroom`<br>(inside a session: `/plugin marketplace add ATASTECH/pitroom`, `/plugin install pitroom@pitroom`) | The 14 skills, the session-start hook that introduces Pitroom, and a card after each `pitroom` command. The plugin is the published npm package: under 0.5 MB, no dependencies. |
+| **Codex** | `codex plugin marketplace add ATASTECH/pitroom`<br>`codex plugin add pitroom@pitroom`<br>and `npm i -g pitroom` | The 14 skills. Codex plugins have no session-start hook, so Pitroom is not introduced on its own: the skills load when a task matches, or ask for one by name. The `pitroom` command itself comes from npm. |
+| **Any other agent, or only the CLI** | `npm i -g pitroom`<br>`pitroom install` | The CLI, and the skills linked into `~/.agents/skills` and `~/.claude/skills`. |
+
 ```bash
-git clone https://github.com/ATASTECH/pitroom && cd pitroom
-node dist/pitroom.mjs install   # skills → ~/.agents/skills + ~/.claude/skills, launcher → ~/.local/bin/pitroom
-pitroom doctor --probe          # worker CLI, models, permissions, skills, one live round trip
+pitroom doctor --probe   # worker CLI, models, permissions, skills, one live round trip
 ```
 
-Or, in Claude Code, install it as a plugin (skills plus the session-start hook), from a clone or the repository:
+Pick one path: `doctor` warns if the skills load twice. To run `pitroom` yourself in a terminal (`watch`, `savings`, the status line below), install it from npm as well; the plugins alone do not put it on your PATH.
 
-```text
-/plugin marketplace add /path/to/pitroom
-/plugin install pitroom@pitroom
-```
+### Your first run
 
-Use one or the other, not both (`doctor` warns if the skills load twice). Pitroom is a toolbox, not a procedure: your agent uses it when it helps, or you ask explicitly:
+Pitroom is a toolbox, not a procedure: your agent uses it when it helps, or you ask explicitly:
 
 > Use pitroom to map how sessions are created and invalidated, then propose a fix.
 > Split this into a pitroom crew: audit auth, billing and uploads for missing input validation.
 
+Or start a worker yourself and read its receipt:
+
+```bash
+pitroom "Which files read the session cookie? Cite file:line."
+pitroom savings          # what all your runs saved so far
+```
+
 ---
 
 ## Modes

package/dist/pitroom.mjs

@@ -2720,7 +2720,7 @@ function inside(file, roots) {
 var escape = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 
 // src/core/run.ts
-var VERSION2 = true ? "0.6.0" : "0.0.0-dev";
+var VERSION2 = true ? "0.6.1" : "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");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pitroom",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "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.",
   "type": "module",
   "author": "TahaAtas",