thoth-agents 0.9.4 → 0.9.5

package/README.md

@@ -14,7 +14,7 @@
     <a href="#install">Install</a> ·
     <a href="#get-started">Get started</a> ·
     <a href="#meet-the-team">The team</a> ·
-    <a href="#choose-your-workflow">Workflows</a> ·
+    <a href="#proportional-sdd">Workflows</a> ·
     <a href="#documentation">Documentation</a>
   </p>
 </div>
@@ -49,10 +49,10 @@ verification you can follow—without manually coordinating every agent.
   memory lifecycle, persistence, and storage; thoth-agents only invokes its setup.
 
 > [!NOTE]
-> Pi is the default harness and our recommendation for the best Thoth-Agents
-> experience. All four harnesses share the workflow and role design, but their
-> permissions, delegation, and runtime capabilities are not identical. Your
-> harness's trust and approval rules still apply.
+> OpenCode is the CLI's default harness. Pi is our recommendation for the best
+> Thoth-Agents experience. All four harnesses share the workflow and role design,
+> but their permissions, delegation, and runtime capabilities are not identical.
+> Your harness's trust and approval rules still apply.
 
 ## Install
 
@@ -64,12 +64,17 @@ The commands below install at **global/user scope**.
 | --- | --- | --- |
 | <a href="https://github.com/anomalyco/opencode"><picture><source media="(prefers-color-scheme: dark)" srcset="https://svgl.app/library/opencode-dark.svg"><img src="https://svgl.app/library/opencode.svg" alt="OpenCode logo" width="48" height="48"></picture></a><br>**OpenCode** | Native plugin, agent team, workflow skills, and memory setup. | `npx thoth-agents@latest install --agent=opencode` |
 | <a href="https://github.com/openai/codex"><img src="https://github.com/openai.png?size=120" alt="OpenAI logo — Codex" width="48" height="48"></a><br>**Codex** | Native plugin plus the required global agent and instruction setup. **Close Codex first.** | `npx thoth-agents@latest install --agent=codex` |
-| <a href="https://claude.com/product/claude-code"><img src="https://github.com/anthropics.png?size=120" alt="Anthropic logo — Claude Code" width="48" height="48"></a><br>**Claude Code** | Marketplace agents and skills, completed by the CLI's external skills and memory setup. **Run the prerequisites below first.** | `npx thoth-agents@latest install --agent=claude` |
+| <a href="https://claude.com/product/claude-code"><img src="https://github.com/anthropics.png?size=120" alt="Anthropic logo — Claude Code" width="48" height="48"></a><br>**Claude Code** | Marketplace agents and skills, completed by the CLI's external skills and memory setup. | `npx thoth-agents@latest install --agent=claude` |
 | <a href="https://github.com/earendil-works/pi"><img src="https://raw.githubusercontent.com/EremesNG/thoth-mem/master/img/pi.svg" alt="Pi logo" width="48" height="48"></a><br>**Pi** | Native package, five specialists, delegation, research, theme, sidebar and background-task extensions, workflow skills, and memory setup. **Recommended for the best experience.** | `npx thoth-agents@latest install --agent=pi` |
 
-### Claude Code prerequisites
+Codex hooks require your trust; installation does not silently grant it. Consent
+during setup, or review and trust them in Codex via `/hooks` or the startup
+**Trust all and continue** prompt. Trusted hooks can run outside the sandbox.
 
-Run these two commands **before** the Claude CLI install command in the table:
+### Claude Code marketplace setup
+
+The CLI registers a missing marketplace and installs or enables the plugin as
+needed. These commands are an optional manual alternative:
 
 ```bash
 claude plugin marketplace add https://github.com/EremesNG/thoth-plugins.git --scope user
@@ -81,8 +86,9 @@ claude plugin install thoth-agents@thoth-plugins --scope user
 > without writing changes. After installation, restart your harness; Claude Code
 > also supports `/reload-plugins`.
 
-Inside Pi, use `/subagents-model` to edit model and effort profiles for global
-and project subagent definitions. See [subagent profile configuration](docs/installation.md#configure-subagent-model-profiles-inside-pi).
+Inside Pi, use `/subagents-model` to edit named model and effort profiles for
+subagents and the orchestrator, stored separately from definitions at global or
+project scope. See [subagent profile configuration](docs/installation.md#configure-subagent-model-profiles-inside-pi).
 Both commands are registered by pi-subagents on pi-core's shared list-editor
 shell, with native CSI-u/kitty and legacy navigation keys and wheel support in
 regular and fullscreen TUI mode. Use `/subagents-tools` to edit resolved global/project definitions' tool
@@ -111,17 +117,22 @@ points Pi at the fork under `pi-packages/pi-subagents`; publishing the fork is
 not required for that path. Pi extensions run with your user's system
 permissions; agent tool allowlists are not an OS sandbox.
 
-### Optional Pi provider extensions (manual install)
+### Optional Pi extensions (manual install)
 
-The installer does **not** install or manage the Claude/Antigravity bridges or
-pi-openai-fast. Install only those you want, then restart Pi:
+The installer does **not** install or manage the Claude/Antigravity bridges,
+pi-openai-fast, or pi-askcodex. Install only those you want, then restart Pi:
 
 ```bash
 pi install npm:@thoth-agents/pi-claude-bridge
 pi install npm:@thoth-agents/pi-antigravity-bridge
 pi install npm:@thoth-agents/pi-openai-fast
+pi install npm:@thoth-agents/pi-askcodex
 ```
 
+`pi-askcodex` adds the `AskCodex` delegation tool, not a model provider, and
+requires Codex Desktop with a working Codex login. See its
+[package guide](pi-packages/pi-askcodex/README.md) for requirements and approvals.
+
 Authenticate Claude Code or the `agy` CLI separately. Claude rate-limit events
 from root and child sessions share pi-core's process-wide, account-wide registry
 (not a bus channel); affected subagent rows/details show active warnings and reset
@@ -132,6 +143,24 @@ mapping, not subscription charges. The theme marks the total `(sub)` by default
 for both `claude-bridge` and `antigravity`. See
 [provider commands and caveats](docs/installation.md#manual-pi-provider-extensions).
 
+### Pi package inventory
+
+The eleven first-party `@thoth-agents/pi-*` packages are:
+
+| Package | Setup |
+| --- | --- |
+| [`@thoth-agents/pi-antigravity-bridge`](pi-packages/pi-antigravity-bridge/README.md) | Optional/manual |
+| [`@thoth-agents/pi-askcodex`](pi-packages/pi-askcodex/README.md) | Optional/manual |
+| [`@thoth-agents/pi-background-tasks`](pi-packages/pi-background-tasks/README.md) | Installer-managed |
+| [`@thoth-agents/pi-claude-bridge`](pi-packages/pi-claude-bridge/README.md) | Optional/manual |
+| [`@thoth-agents/pi-core`](pi-packages/pi-core/README.md) | Shared library; not installer-managed |
+| [`@thoth-agents/pi-openai-fast`](pi-packages/pi-openai-fast/README.md) | Optional/manual |
+| [`@thoth-agents/pi-questions-user`](pi-packages/pi-questions-user/README.md) | Installer-managed |
+| [`@thoth-agents/pi-sidebar`](pi-packages/pi-sidebar/README.md) | Installer-managed |
+| [`@thoth-agents/pi-subagents`](pi-packages/pi-subagents/README.md) | Installer-managed |
+| [`@thoth-agents/pi-thoth-theme`](pi-packages/pi-thoth-theme/README.md) | Installer-managed |
+| [`@thoth-agents/pi-todo`](pi-packages/pi-todo/README.md) | Installer-managed |
+
 For scopes, troubleshooting, or local checkout installation, see the
 [installation guide](docs/installation.md). Local Pi checkout installs keep
 thoth-mem setup separate.
@@ -242,6 +271,10 @@ historical records remain preserved, and provider memory stays separate. Native
 harness execution and liveness remain authoritative. See the [SDD guide](docs/sdd-pipeline.md)
 and [Skills and MCPs](docs/skills-and-mcps.md) for limits.
 
+Shipped skills: `thoth-init`, `thoth-sdd`, `thoth-constitution`,
+`thoth-archive`, and `plan-reviewer`. The CLI also installs the mandatory external
+skills `simplify`, `tdd`, `progressive-context-router`, and `grill-me`.
+
 ## Configure and update
 
 ### Tune the team
@@ -276,6 +309,11 @@ skills and provider setup—not just the plugin. Native marketplace updates alon
 do not prove those other pieces are current. Use `status` to inspect the last
 complete CLI-managed installation and follow any reported recovery actions.
 
+For Codex, `npx thoth-agents@latest doctor --agent=codex` provides read-only
+diagnostics. To remove attributable Codex surfaces, preview with
+`npx thoth-agents@latest uninstall --agent=codex --dry-run`, then omit `--dry-run`
+to apply.
+
 For Pi, the first-party `thoth-agents` package remains exact and receipt-verified.
 The nine selected extensions use stable minimum-only `>=` ranges, so
 Pi's native package manager can update them independently without waiting for a
@@ -312,9 +350,10 @@ visibility, startup and default width; `/sidebar cost` opens task-cost curves
 against elapsed time per task, labeled by display name or a short task-summary name.
 Themed Agents/Background headers show static status-icon counts, omitting zero
 counts (Todos keeps completed/total), and detail commands; Workspace shows a
-`~`-abbreviated path and tracked file/line changes versus HEAD. Agent metrics
-include all available metrics with semantic icons (ASCII labels) in shared
-aligned columns that wrap without dropping metrics, stably across digit changes. Only displayed source panels absorb their
+`~`-abbreviated path and tracked file/line changes versus HEAD. The Agents panel
+uses a two-line plan: identity, summary and elapsed on line one; a width-dependent
+priority prefix of metrics on line two. Lower-priority metrics are dropped as
+width shrinks. Only displayed source panels absorb their
 Work sections; hiding the sidebar restores them. Panel order/visibility and
 startup policy/default width live in `~/.pi/agent/thoth-sidebar.json`. Subagent
 state v2 adds up to 100 cost-ranked persisted session summaries in `history`. Private Pi layout seams
@@ -350,6 +389,7 @@ visible foreign-overlay focus. See [question controls](pi-packages/pi-questions-
 ### Technical guides
 
 Working on thoth-agents itself? Start here rather than in the user setup above.
+Use **`pnpm@11.2.2`** for local development.
 
 | Guide | What it covers |
 | --- | --- |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thoth-agents",
-  "version": "0.9.4",
+  "version": "0.9.5",
   "description": "Adaptive multi-harness orchestration with six roles, runtime-autonomous AI-first execution routes, and external provider boundaries.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "thoth-agents",
-  "version": "0.9.4",
+  "version": "0.9.5",
   "description": "Adaptive multi-harness agent pack with six roles and proportional SDD governance for Claude Code.",
   "author": {
     "name": "thoth-agents"

package/plugin/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "thoth-agents",
-  "version": "0.9.4",
+  "version": "0.9.5",
   "description": "Bundled AI-first work skills and MCP configuration; the six-role global Codex layer requires thoth-agents CLI setup.",
   "skills": "./skills/",
   "mcpServers": "./codex.mcp.json",