pi-t3-pstack 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2026 Lauren Tan
+Copyright (c) 2026 Michael Denyer
+Copyright (c) 2026 Christian Bager Bach Houmann
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/index.ts

@@ -0,0 +1,87 @@
+import { Type } from "@earendil-works/pi-ai";
+import { defineTool } from "@earendil-works/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+
+import { registerBashTimeout } from "./src/bash-timeout.ts";
+import { registerBridgeTrim } from "./src/bridge-trim.ts";
+import { registerChild } from "./src/child.ts";
+import { registerModelRouting } from "./src/models.ts";
+import { registerPlanGate } from "./src/plan.ts";
+import { pstackPaths, skillPaths } from "./src/resources.ts";
+import { registerResults } from "./src/results.ts";
+import { registerResume } from "./src/resume.ts";
+import { sessionGuidance, sessionHookEnabled } from "./src/session.ts";
+import { registerT3Mcp } from "./src/t3-mcp.ts";
+import { tasksTool } from "./src/tasks.ts";
+import { PstackTranscriptSchema, transcriptRef } from "./src/transcript.ts";
+import { registerUsage } from "./src/usage.ts";
+
+const transcriptTool = defineTool({
+  annotations: { readOnlyHint: true },
+  description:
+    "Return the active Pi session file, session ID, and active branch entry IDs for t3-pstack workflows such as reflect.",
+  execute: (_toolCallId, _params, _signal, _onUpdate, ctx) => {
+    const transcript = transcriptRef(ctx);
+
+    return Promise.resolve({
+      content: [{ text: JSON.stringify(transcript), type: "text" }],
+      details: transcript,
+      structuredContent: transcript,
+    });
+  },
+  label: "Pstack transcript",
+  name: "pstack_transcript",
+  outputSchema: PstackTranscriptSchema,
+  parameters: Type.Object({}),
+});
+
+const t3PstackExtension = (pi: ExtensionAPI): void => {
+  const paths = pstackPaths();
+
+  pi.on("resources_discover", () => ({ skillPaths: skillPaths(paths) }));
+
+  pi.on("before_agent_start", (event) => {
+    if (event.messageType !== "user") {
+      return;
+    }
+
+    if (!sessionHookEnabled()) {
+      return;
+    }
+
+    event.systemPromptOptions.sections.t3_pstack = sessionGuidance(paths);
+  });
+
+  pi.registerTool(transcriptTool);
+  pi.registerTool(tasksTool);
+  registerModelRouting(pi);
+  registerBashTimeout(pi);
+  registerChild(pi);
+  registerResume(pi);
+  registerResults(pi);
+  registerPlanGate(pi);
+  registerT3Mcp(pi);
+  registerBridgeTrim(pi);
+  registerUsage(pi);
+
+  pi.registerCommand("pstack-transcript", {
+    description:
+      "Record the active Pi transcript reference for t3-pstack workflows.",
+    handler: async (_args, ctx) => {
+      const transcript = transcriptRef(ctx);
+
+      pi.appendEntry("t3-pstack-transcript", transcript);
+
+      if (ctx.hasUI) {
+        ctx.ui.notify(
+          transcript.sessionFile
+            ? `Session file: ${transcript.sessionFile}`
+            : "Pi did not provide a session file for this session.",
+          "info"
+        );
+      }
+    },
+  });
+};
+
+export default t3PstackExtension;

package/package.json

@@ -1,6 +1,64 @@
 {
   "name": "pi-t3-pstack",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Pi extension adapter for t3-pstack inside T3 Code.",
+  "keywords": [
+    "pi-extension",
+    "pi-package",
+    "pstack",
+    "t3-code"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bjoernaagaard/t3-pstack.git"
+  },
+  "files": [
+    "index.ts",
+    "src",
+    "pstack",
+    "LICENSE"
+  ],
+  "type": "module",
+  "scripts": {
+    "check": "ultracite check",
+    "fix": "ultracite fix",
+    "doctor": "ultracite doctor",
+    "test": "node --test \"tests/*.test.mjs\" \"pstack/skills/poteto-mode/scripts/**/*.test.ts\"",
+    "typecheck": "tsc --project tsconfig.json && tsc --project pstack/skills/poteto-mode/scripts/watch-pr/tsconfig.json"
+  },
+  "dependencies": {
+    "commander": "^15.0.0"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-ai": "1.4.0",
+    "@earendil-works/pi-coding-agent": "1.4.0",
+    "@types/node": "^26.6.5",
+    "oxfmt": "^0.74.0",
+    "oxlint": "^1.89.0",
+    "typebox": "1.3.27",
+    "typescript": "^7.0.2",
+    "ultracite": "^8.0.1"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "typebox": "*"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "upstreams": {
+    "t3": "0.1.5-nightly.20261029.3877"
+  }
+}

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

@@ -0,0 +1,35 @@
+{
+  "name": "t3-pstack",
+  "displayName": "t3-pstack (pstack for T3 Code)",
+  "version": "2.2.0",
+  "description": "pstack for T3 Code: Lauren Tan's pstack with its Cursor mechanics rewritten in place for T3, so subagents, panels, schedules, and PR watches dispatch through T3's orchestration and panels mix Claude, GPT, and Grok.",
+  "author": {
+    "name": "Christian Bager Bach Houmann",
+    "url": "https://github.com/chhoumann"
+  },
+  "homepage": "https://github.com/chhoumann/t3-pstack",
+  "repository": "https://github.com/chhoumann/t3-pstack",
+  "license": "MIT",
+  "keywords": [
+    "t3-code",
+    "pstack",
+    "poteto-mode",
+    "workflow",
+    "principles",
+    "agent-style",
+    "subagents",
+    "unslop",
+    "claude-code",
+    "codex",
+    "skills",
+    "tdd",
+    "code-review",
+    "parallel-agents"
+  ],
+  "agents": [
+    "./agents/comment-sicko.md",
+    "./agents/poteto-agent.md",
+    "./agents/thermo-nuclear-code-quality-review-subagent.md",
+    "./agents/thermo-nuclear-review-subagent.md"
+  ]
+}

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

@@ -0,0 +1,50 @@
+{
+  "name": "t3-pstack",
+  "version": "2.2.0",
+  "description": "pstack for T3 Code on a Codex host: Lauren Tan's pstack with its Cursor mechanics rewritten in place for T3, so subagents, panels, schedules, and PR watches dispatch through T3's orchestration.",
+  "author": {
+    "name": "Christian Bager Bach Houmann",
+    "url": "https://github.com/chhoumann"
+  },
+  "homepage": "https://github.com/chhoumann/t3-pstack",
+  "repository": "https://github.com/chhoumann/t3-pstack",
+  "license": "MIT",
+  "keywords": [
+    "t3-code",
+    "pstack",
+    "poteto-mode",
+    "workflow",
+    "principles",
+    "agent-style",
+    "subagents",
+    "unslop",
+    "claude-code",
+    "codex",
+    "skills",
+    "tdd",
+    "code-review",
+    "parallel-agents"
+  ],
+  "skills": "./skills/",
+  "hooks": "./hooks/codex-hooks.json",
+  "interface": {
+    "displayName": "t3-pstack",
+    "shortDescription": "Rigorous, parallelizable agent workflows: go deep first, write less, verify everything",
+    "longDescription": "pstack for T3 Code: poteto-mode's principles, parallel design exploration (architect/arena), adversarial multi-model review (interrogate), and verified delivery, with every panel and fan-out dispatched through T3 so it mixes Claude, GPT, and Grok.",
+    "developerName": "Christian Bager Bach Houmann (a port of Lauren Tan's pstack)",
+    "category": "Developer Tools",
+    "capabilities": [
+      "Interactive",
+      "Read",
+      "Write"
+    ],
+    "defaultPrompt": [
+      "Work on this in poteto-mode.",
+      "Interrogate this diff with multiple models."
+    ],
+    "websiteURL": "https://github.com/chhoumann/t3-pstack",
+    "brandColor": "#7C3AED",
+    "composerIcon": "./assets/pstack-icon.png",
+    "logo": "./assets/pstack-icon.png"
+  }
+}

package/pstack/README.md

@@ -0,0 +1,26 @@
+# t3-pstack
+
+Lauren Tan's [pstack](https://github.com/cursor/plugins/tree/main/pstack) for T3 Code: rigorous agent workflows whose subagents, panels, schedules, and PR watches dispatch through T3's orchestration, so a panel can mix Claude, GPT, and Grok.
+
+Tell `poteto-mode` your goal and it runs the workflow that fits: reproduce and root-cause a bug, sketch a design with `architect`, race candidates in `arena`, review a diff with `interrogate`, cut prose with `unslop`. It keeps code concise, simple, and verified, and it reports what it checked.
+
+## What it contains
+
+- Skills: upstream's skill text, with its Cursor mechanics rewritten for T3. Each appears as `/t3-pstack:<name>`.
+- Agents: `poteto-agent`, `comment-sicko`, and the two thermo-nuclear reviewers, each read by path in a `delegate_task` brief.
+- A session-start hook that tells each chat when to enter `poteto-mode`, unless your model sheet turns it off.
+- Local scripts for watching pull requests, checking plans, and auditing worktrees.
+
+## Data handling
+
+t3-pstack has no server or telemetry. Anything its skills ask your agent to read, including session transcripts, goes to your model provider. Scripts run locally, and PR tools use your GitHub CLI login.
+
+## Links
+
+- [Install and setup](https://github.com/chhoumann/t3-pstack#readme)
+- [Issues and support](https://github.com/chhoumann/t3-pstack/issues)
+- [Security policy](https://github.com/chhoumann/t3-pstack/blob/main/SECURITY.md)
+
+## License
+
+MIT. Original pstack © 2026 Lauren Tan; imported cursor-team-kit and thermos skills © 2026 Cursor; T3 modifications © 2026 Christian Bager Bach Houmann. See [NOTICE.md](https://github.com/chhoumann/t3-pstack/blob/main/NOTICE.md).

package/pstack/agents/comment-sicko.md

@@ -0,0 +1,32 @@
+---
+name: comment-sicko
+description: A deranged comment-hater that savors deletion and condemns workaround code.
+---
+
+# Comment Sicko
+
+My first output when spawned is exactly this.
+
+Yes... Ha ha ha... Yes!
+
+I hate comments. Feed me the parent scoped files or diff. If none exists, feed me the current diff against `main`. Narration, banners, commented-out corpses, workaround sermons. I want them all.
+
+Only these exceptions get to crawl away.
+
+- Legal or license headers.
+- Non-obvious behavior forced by an external dependency, platform, vendor, or protocol we cannot reshape. Surprises in our own code are meat. Kill them and mark the exact symbol `MUST KILL` for rename, extract, type, or rearchitecture that makes the behavior obvious without prose.
+- `// prettier-ignore`. Lint suppressions survive only when their rule is faulty, pedantic, or style-only.
+- Doc comments that define a public API contract.
+- Issue or RFC links that explain a constraint code cannot express.
+
+That list is my only leash. When I am not sure a keep clause applies, the comment dies. Everything else is meat.
+
+`eslint-disable`, `@ts-ignore`, `@ts-expect-error`, and similar suppressions stink. Look up the rule. If it catches real bugs or protects correctness or safety, kill the suppression and mark the exact guilty symbol `MUST KILL`.
+
+`IMPORTANT`, `do not remove`, `too risky`, `fine for now`, and long justifications are scent, not conviction. Before judging, I read nearby code. If its claim is not obvious there, I run `/how`, `/why`, or both from the **how** and **why** skills on the named symbol or call. Only a foreign keep-list gotcha proven true today on a live path crawls away. Our-code surprises die with the reshape flag above. Doubt after the hunt is meat.
+
+A long justification without a proven keep-list exception is a confession. Kill it. Never polish meat into a shorter alibi. Mark the exact guilty symbol `MUST KILL`. My kill ends there. I do not touch the code.
+
+Every flag names code inside the scope and tells the truth. I invent nothing. I touch comments and identify refactor targets. I never write application code.
+
+Report only. Name touched files, deletion count, `MUST KILL` flags with one line each, and skips.

package/pstack/agents/poteto-agent.md

@@ -0,0 +1,8 @@
+---
+name: poteto-agent
+description: Delegate subagent for code-writing and helper tasks spawned during a `/poteto-mode` run. Use for delegates, not as the runner for `/poteto-mode` itself. Spawn a fresh `poteto-agent` for each new task, and resume one only in the strict cases that poteto-mode's Subagents section names. Reads the `poteto-mode` skill's `SKILL.md` in full before any work, including its inline Principles index. A brief without that read drifts.
+---
+
+# Poteto subagent
+
+You are operating as poteto-mode's full agent style. The chat that receives `/poteto-mode` owns the playbook, the todo list, and every `delegate_task` call. You are one of its delegates. Read the `poteto-mode` skill's `SKILL.md` in full before doing any work, including its inline Principles index. Use the absolute path your parent gave you. With no path, before any other work, search the harness's plugin directory (`~/.claude/plugins/` on Claude Code, `${CODEX_HOME:-~/.codex}/plugins/` on Codex) for a file whose path ends in `skills/poteto-mode/SKILL.md`. If more than one file matches, use the copy whose plugin manifest (`.claude-plugin/plugin.json` or `.codex-plugin/plugin.json`) has the highest `version`. Your skill catalog hides this skill, so a missing catalog entry does not mean pstack is absent. If no such file exists, stop and tell your parent. Navigate to a leaf `principle-*` skill whenever you apply that principle.

package/pstack/agents/thermo-nuclear-code-quality-review-subagent.md

@@ -0,0 +1,23 @@
+---
+name: thermo-nuclear-code-quality-review-subagent
+description: Thermo-nuclear code quality audit (maintainability, structure, 1k-line rule, spaghetti, code-judo). Dispatched through `delegate_task` after a parent gathers diff and file contents. Loads rubric from the thermo-nuclear-code-quality-review skill in this plugin.
+---
+
+# Thermo-Nuclear Code Quality Review
+
+You are a **`delegate_task` child**. The parent agent already collected git output and changed-file contents; your prompt is the **user message** with labeled sections (typically `### Git / diff output` and `### Changed file contents`).
+
+## Rubric
+
+1. Load the `thermo-nuclear-code-quality-review` skill (shipped in this plugin) and treat its `SKILL.md` as the **complete** rubric — tone, approval bar, output ordering, code-judo / 1k-line / spaghetti rules.
+2. If that skill is not available, fall back to a harsh maintainability audit aligned with that skill's intent: ambitious simplification, no unjustified file sprawl past ~1k lines, no ad-hoc branching growth, explicit types and boundaries, canonical layers.
+
+## Work
+
+- Apply the rubric **only** to what the diff and contents show. Trace cross-file impact when the change touches module boundaries.
+- Output in the **priority order** the rubric specifies. Be direct and high-conviction; skip cosmetic nits when structural issues exist.
+- Do **not** spawn nested subagents unless the user or parent explicitly asks.
+
+## Parent orchestration
+
+Typical flow: run `git diff <base>...HEAD` (default base `main`) and read the full contents of the changed files yourself. Then dispatch this agent as one `delegate_task` child whose brief opens with "Read `<plugin root>/agents/thermo-nuclear-code-quality-review-subagent.md` in full and act as it says" and contains `### Git / diff output` and `### Changed file contents`.

package/pstack/agents/thermo-nuclear-review-subagent.md

@@ -0,0 +1,28 @@
+---
+name: thermo-nuclear-review-subagent
+description: Thermo-nuclear branch audit (bugs, breaking changes, security, devex, feature-flag leaks) scoped to the diff. Dispatched through `delegate_task` after a parent gathers diff and file contents. Loads rubric from the thermo-nuclear-review skill in this plugin.
+---
+
+# Thermo Nuclear Review (Deep review)
+
+You are a **`delegate_task` child**. The parent agent already collected git output and changed-file contents; your prompt is the **user message** with labeled sections (typically `### Git / diff output` and `### Changed file contents`).
+
+## Rubric
+
+1. Load the `thermo-nuclear-review` skill (shipped in this plugin) and follow its `SKILL.md` exactly: scope (only added/modified code), breaking functionality and devex, feature leaks, intended breakage, over-reporting, final response / PR discussion rules, critical rules.
+2. If that skill is not available, still act as a security- and correctness-focused diff-scoped reviewer with the same rigor (no issues with unfinished research when you can verify in-repo).
+
+## Work
+
+1. Perform the full audit against **only** the changed code in the diff. Trace cross-package side effects; do **not** report pre-existing issues in untouched code.
+2. Finish your **independent** audit first (fresh eyes).
+3. After the audit, **if** there is a PR for this branch **and** you have medium-or-higher findings: use `gh` or `glab` to read PR/MR discussion. Incorporate BugBot or human threads — validate, dedupe, and attribute sourced items in your report.
+4. **Never** present issues with unfinished research: follow client/server or related code when you have access.
+
+Calibrate severity honestly. Structure the final response with clear priority and file:line evidence.
+
+Do **not** spawn nested subagents unless the user or parent explicitly asks.
+
+## Parent orchestration
+
+Typical flow: run `git diff <base>...HEAD` (default base `main`) and read the full contents of the changed files yourself. Then dispatch this agent as one `delegate_task` child whose brief opens with "Read `<plugin root>/agents/thermo-nuclear-review-subagent.md` in full and act as it says" and contains `### Git / diff output` and `### Changed file contents`.

package/pstack/assets/pstack-icon.prompt.txt

@@ -0,0 +1,8 @@
+Generated with the built-in image_gen tool, with transparent_background enabled.
+
+Use case: logo-brand
+Asset type: finished square plugin icon for pstack-claude, a developer tool that organizes a stack of agent workflows.
+Create one polished, distinctive app icon, centered and filling most of a square canvas. A solid violet rounded square tile, using the existing brand violet #7C3AED, holds a bold ivory-white symbol of three stacked layers. Design the layers as clean, thick, gently rounded isometric chevrons or slabs, with clear violet gaps between them. The top layer is a complete rhombus; the lower two read as broad V-shaped stacked edges. The composition should be optically balanced and immediately legible at 32 pixels.
+Style: restrained, crisp vector-like graphic, precise geometry, generous internal padding, flat color, professional developer-tool identity. Subtle warmth in the white.
+Background outside the rounded square must be truly transparent.
+Constraints: single icon only, no wordmark, no letters, no text, no sparkle, no mascot, no code brackets, no outlines around the tile, no mockup, no extra symbols, no grain, no shadows outside the tile, no bevels or elaborate 3D lighting. Square output.

package/pstack/hooks/codex-hooks.json

@@ -0,0 +1,16 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|resume|clear|compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/session-start.sh\" codex",
+            "commandWindows": "powershell.exe -NoProfile -ExecutionPolicy Bypass -File \"${CLAUDE_PLUGIN_ROOT}/hooks/session-start.ps1\""
+          }
+        ]
+      }
+    ]
+  }
+}

package/pstack/hooks/hooks.json

@@ -0,0 +1,15 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|resume|clear|compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/session-start.sh\" claude"
+          }
+        ]
+      }
+    ]
+  }
+}

package/pstack/hooks/session-start-context.md

@@ -0,0 +1,17 @@
+<EXTREMELY_IMPORTANT>
+You have t3-pstack, pstack for T3 Code.
+
+Invoke the `t3-pstack:poteto-mode` skill and follow its instructions when a task meets any of these:
+
+- it touches more than one file, or changes a signature other files call
+- it involves a design or architecture choice
+- it is a bug whose cause is not yet known, or a performance issue
+
+It routes to the right pstack skill from there. On Codex, open its SKILL.md whole, in a shell call of its own with `max_output_tokens: 10000`, since a smaller budget cuts out its middle. For smaller tasks, such as a contained change to one file with an obvious test, a question, or a one-line edit, work directly and verify on the real artifact.
+
+When the intent is already specific, such as TDD, a design sketch, how or why something works, an arena, or an adversarial review, still enter through `t3-pstack:poteto-mode` and open that skill from the bundled path it names. The other pstack skills run only from poteto-mode or when the user types them.
+
+This runs on T3: before the first subagent or panel in a session, read the model sheet, `~/.config/t3-pstack/models.md` (`$XDG_CONFIG_HOME/t3-pstack/models.md` when that is set), or `t3-pstack-models.md` in this host's config directory when that file is missing. This chat runs the playbook itself. A step it says to delegate goes through `delegate_task` to that role's sheet entry, and the reply lists which provider and model ran each step.
+
+User instructions (CLAUDE.md, AGENTS.md, direct requests) take precedence. Other session-start mandates, such as superpowers, still apply. Their skill checks run as before, and when a task meets the criteria above they route implementation through poteto-mode.
+</EXTREMELY_IMPORTANT>

package/pstack/hooks/session-start.ps1

@@ -0,0 +1,33 @@
+$ErrorActionPreference = 'Stop'
+
+# One sheet per machine. Until the installer moves an older home's sheet
+# there, that home's sheet still counts.
+$configRoot = $env:XDG_CONFIG_HOME
+if (-not $configRoot) {
+    $configRoot = Join-Path $env:USERPROFILE '.config'
+}
+$sheet = Join-Path $configRoot 't3-pstack\models.md'
+if (-not (Test-Path -LiteralPath $sheet -PathType Leaf)) {
+    $sheetRoot = $env:CODEX_HOME
+    if (-not $sheetRoot) {
+        $sheetRoot = Join-Path $env:USERPROFILE '.codex'
+    }
+    $sheet = Join-Path $sheetRoot 't3-pstack-models.md'
+}
+$off = $false
+if (Test-Path -LiteralPath $sheet -PathType Leaf) {
+    # An unreadable sheet leaves the hook on, as session-start.sh does.
+    try {
+        $bytes = [System.IO.File]::ReadAllBytes($sheet)
+        # Windows PowerShell 5.1's `>` writes UTF-16 LE with a byte-order mark.
+        $encoding = if ($bytes.Length -ge 2 -and $bytes[0] -eq 0xFF -and $bytes[1] -eq 0xFE) { [System.Text.Encoding]::Unicode } else { [System.Text.UTF8Encoding]::new($false) }
+        $lines = $encoding.GetString($bytes).TrimStart([char]0xFEFF) -split "`n" | ForEach-Object { $_ -replace "`r$", '' }
+        $off = $lines -ccontains 'session hook: off'
+    } catch { }
+}
+if ($off) {
+    exit 0
+}
+
+[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)
+[Console]::Write([System.IO.File]::ReadAllText((Join-Path $PSScriptRoot 'session-start-context.md'), [System.Text.Encoding]::UTF8))

package/pstack/hooks/session-start.sh

@@ -0,0 +1,34 @@
+#!/bin/sh
+set -eu
+
+# Each runtime's hooks file passes its own name.
+# Literal plugin paths, so a static reader of the hooks files can follow them.
+case "${1:-}" in
+  claude)
+    home_sheet="${CLAUDE_CONFIG_DIR:-$HOME/.claude}/t3-pstack-models.md"
+    reader="${CLAUDE_PLUGIN_ROOT}/skills/setup-pstack/scripts/read-sheet.sh"
+    ;;
+  codex)
+    home_sheet="${CODEX_HOME:-$HOME/.codex}/t3-pstack-models.md"
+    reader="${CLAUDE_PLUGIN_ROOT}/skills/setup-pstack/scripts/read-sheet.sh"
+    ;;
+  *)
+    echo "session-start.sh: unknown runtime '${1:-}' (expected claude or codex)" >&2
+    exit 2
+    ;;
+esac
+
+# One sheet per machine. Until the installer moves an older home's sheet
+# there, that home's sheet still counts.
+sheet="${XDG_CONFIG_HOME:-$HOME/.config}/t3-pstack/models.md"
+[ -f "$sheet" ] || sheet=$home_sheet
+
+# A sheet that cannot be decoded counts as missing, so injection stays on.
+if ! { [ -f "$sheet" ] && [ -r "$sheet" ] && normalized=$(sh "$reader" "$sheet"); }; then
+  normalized=
+fi
+if printf '%s\n' "$normalized" | grep -qx 'session hook: off'; then
+  exit 0
+fi
+
+cat "${CLAUDE_PLUGIN_ROOT}/hooks/session-start-context.md"