Skip to content
Back to search

pstack-claude

MarketplaceWorks with Claude CodeGitHub

Claude Code port of poteto's pstack. Rigorous agent workflows with Cursor primitives translated to Claude Code equivalents.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/michael-denyer-pstack-claude/badge.svg)](/listings/michael-denyer-pstack-claude)

HTML

<a href="/listings/michael-denyer-pstack-claude"><img src="/api/listings/michael-denyer-pstack-claude/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

<details> <summary><strong>Claude Code</strong></summary>

Run in Claude Code 2.1.292 or later:

/plugin marketplace add michael-denyer/pstack-claude
/plugin install pstack@pstack-claude

Claude Code leaves auto-update off for third-party marketplaces, so pstack stays on the version you installed. To turn it on, run `/plugin`, open the **Marketplaces** tab, select `pstack-claude`, and choose **Enable auto-update**. To update once by hand, run `claude plugin update pstack@pstack-claude`.

</details>

<a id="codex"></a> <details> <summary><strong>Codex</strong></summary>

Run in your terminal:

codex plugin marketplace add michael-denyer/pstack-claude
codex plugin add pstack@pstack-claude

Invoke a skill by typing `$` and its name, such as `$poteto-mode` or `$babysit`, then choosing its entry, which inserts `$pstack:<name>`. `/skills` lists every skill.

</details>

<details> <summary><strong>Pi</strong></summary>

Run in your terminal, with Pi 1.5.1 or later:

pi install git:github.com/michael-denyer/pstack-claude

The package loads the skills and the pstack Pi extension, which adds the subagent, question, and wake-up tools the skills use, plus `/loop` and the routing instruction. Invoke a skill with `/skill:<name>`.

</details>

<details> <summary><strong>GitHub Copilot</strong></summary>

Run in your terminal:

copilot plugin marketplace add michael-denyer/pstack-claude
copilot plugin install pstack@pstack-claude

This installs pstack for the Copilot CLI and the GitHub Copilot app, which share `~/.copilot`. Start a new session afterwards. Copilot ships no default pstack models, so the first skill that needs one runs `setup-pstack` to pick from the models your account lists, and later sessions reuse that choice.

The Copilot build is tested on Copilot CLI 1.0.87 through 1.0.92. On those versions the routing hook's context reaches the session alongside other plugins' session-start context. If a later version keeps only one plugin's context, `setup-pstack` offers a [standing instruction](plugins/pstack/skills/setup-pstack/copilot.md#wire-it-in) for `~/.copilot/copilot-instructions.md` instead. On 1.0.92, once the CLI caches its computer-use experiment assignment, `copilot -p` sessions list no plugin skills and a `skill` call returns "Skill not found". Interactive sessions, the hooks, and the agents are unaffected.

</details>

<details> <summary><strong>Muse</strong></summary>

Run in your terminal:

git clone https://github.com/michael-denyer/pstack-claude
cd pstack-claude
muse plugins install ./plugins/pstack
muse plugins approve pstack

The first command installs the native Muse plugin bundle. The second approves its `SessionStart` hook and agent definitions, which Muse runs only after approval. Start a new session afterwards. Invoke a skill with `/<name>` (for example `/poteto-mode`), which Muse lists for each user-invocable skill.

</details>

<details> <summary><strong>OMP</strong></summary>

Run in your terminal:

omp plugin marketplace add michael-denyer/pstack-claude
omp plugin install --scope user pstack@pstack-claude

Restart OMP after installing, disabling, or uninstalling pstack. OMP 18.16.0 shares one plugin cache across scopes, so an upgrade or removal can affect other installations; inspect their source and scope before changing them. See [OMP issue 16827](https://github.com/can1357/oh-my-pi/issues/16827).

</details>

<details> <summary><strong>Kimi Code CLI</strong></summary>

After a release containing `kimi.plugin.json` is published, close other Kimi sessions and install it in a fresh Kimi Code CLI session:

/plugins install https://github.com/michael-denyer/pstack-claude
/reload

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 16 lines
  1. {
  2. "name": "pstack-claude",
  3. "owner": {
  4. "name": "Michael Denyer",
  5. "url": "https://github.com/michael-denyer"
  6. },
  7. "description": "Claude Code port of poteto's pstack. Rigorous agent workflows with Cursor primitives translated to Claude Code equivalents.",
  8. "plugins": [
  9. {
  10. "name": "pstack",
  11. "source": "./plugins/pstack",
  12. "description": "If you want to go fast, go deep first. pstack helps you write less, but higher quality code. rigorous agent workflows you can parallelize with confidence. Original pstack by Lauren Tan (poteto).",
  13. "version": "0.9.139"
  14. }
  15. ]
  16. }
README.md · README · 249 lines
  1. # pstack
  2. [![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-support-yellow?logo=buy-me-a-coffee&logoColor=white)](https://buymeacoffee.com/codenyer)
  3. [![Mentioned in Awesome Claude Code](https://awesome.re/mentioned-badge.svg)](https://github.com/hesreallyhim/awesome-claude-code)
  4. Lauren Tan's [pstack](https://github.com/cursor/plugins/tree/main/pstack) is an opinionated Cursor skill stack that improves agent outcomes. This is a port for Claude Code, Codex, Pi, GitHub Copilot, Muse, and other agent harnesses. It tracks upstream and also carries named policy forks, each declared in [`tools/forks.json`](tools/forks.json).
  5. Tell `poteto-mode` your goal and it will invoke the correct workflow for the task. It keeps your code concise, simple and verified.
  6. For concurrency bugs and invariants that tests cannot reach, `/create-formal-verification-skill` picks the riskiest property in your code, verifies it with a tool that fits, and leaves a project skill the next agent reruns. The separate [agent-formal-verify](https://github.com/michael-denyer/agent-formal-verify) plugin goes deeper on the method, with guided TLA+ model checking, Lean proofs, and Kani for Rust.
  7. ## Built for Claude Code
  8. This port translates upstream's Cursor skills for Claude Code before installation. [Upstream's Claude Code install](https://github.com/cursor/plugins/tree/c742dd6/harness/pstack/claude-code) asks agents to translate Cursor names at runtime, using extra tokens and relying on them to apply the mapping correctly. This port also adds a SessionStart hook that routes tasks to `poteto-mode`.
  9. ## Install
  10. <details>
  11. <summary><strong>Claude Code</strong></summary>
  12. Run in Claude Code 2.1.292 or later:
  13. ```text
  14. /plugin marketplace add michael-denyer/pstack-claude
  15. /plugin install pstack@pstack-claude
  16. ```
  17. Claude Code leaves auto-update off for third-party marketplaces, so pstack stays on the version you installed. To turn it on, run `/plugin`, open the **Marketplaces** tab, select `pstack-claude`, and choose **Enable auto-update**. To update once by hand, run `claude plugin update pstack@pstack-claude`.
  18. </details>
  19. <a id="codex"></a>
  20. <details>
  21. <summary><strong>Codex</strong></summary>
  22. Run in your terminal:
  23. ```shell
  24. codex plugin marketplace add michael-denyer/pstack-claude
  25. codex plugin add pstack@pstack-claude
  26. ```
  27. Invoke a skill by typing `$` and its name, such as `$poteto-mode` or `$babysit`, then choosing its entry, which inserts `$pstack:<name>`. `/skills` lists every skill.
  28. </details>
  29. <details>
  30. <summary><strong>Pi</strong></summary>
  31. Run in your terminal, with Pi 1.5.1 or later:
  32. ```shell
  33. pi install git:github.com/michael-denyer/pstack-claude
  34. ```
  35. The package loads the skills and the pstack Pi extension, which adds the subagent, question, and wake-up tools the skills use, plus `/loop` and the routing instruction. Invoke a skill with `/skill:<name>`.
  36. </details>
  37. <details>
  38. <summary><strong>GitHub Copilot</strong></summary>
  39. Run in your terminal:
  40. ```shell
  41. copilot plugin marketplace add michael-denyer/pstack-claude
  42. copilot plugin install pstack@pstack-claude
  43. ```
  44. This installs pstack for the Copilot CLI and the GitHub Copilot app, which share `~/.copilot`. Start a new session afterwards. Copilot ships no default pstack models, so the first skill that needs one runs `setup-pstack` to pick from the models your account lists, and later sessions reuse that choice.
  45. The Copilot build is tested on Copilot CLI 1.0.87 through 1.0.92. On those versions the routing hook's context reaches the session alongside other plugins' session-start context. If a later version keeps only one plugin's context, `setup-pstack` offers a [standing instruction](plugins/pstack/skills/setup-pstack/copilot.md#wire-it-in) for `~/.copilot/copilot-instructions.md` instead. On 1.0.92, once the CLI caches its computer-use experiment assignment, `copilot -p` sessions list no plugin skills and a `skill` call returns "Skill not found". Interactive sessions, the hooks, and the agents are unaffected.
  46. </details>
  47. <details>
  48. <summary><strong>Muse</strong></summary>
  49. Run in your terminal:
  50. ```shell
  51. git clone https://github.com/michael-denyer/pstack-claude
  52. cd pstack-claude
  53. muse plugins install ./plugins/pstack
  54. muse plugins approve pstack
  55. ```
  56. The first command installs the native Muse plugin bundle. The second approves its `SessionStart` hook and agent definitions, which Muse runs only after approval. Start a new session afterwards. Invoke a skill with `/<name>` (for example `/poteto-mode`), which Muse lists for each user-invocable skill.
  57. </details>
  58. <details>
  59. <summary><strong>OMP</strong></summary>
  60. Run in your terminal:
  61. ```shell
  62. omp plugin marketplace add michael-denyer/pstack-claude
  63. omp plugin install --scope user pstack@pstack-claude
  64. ```
  65. Restart OMP after installing, disabling, or uninstalling pstack. OMP 18.16.0 shares one plugin cache across scopes, so an upgrade or removal can affect other installations; inspect their source and scope before changing them. See [OMP issue 16827](https://github.com/can1357/oh-my-pi/issues/16827).
  66. </details>
  67. <details>
  68. <summary><strong>Kimi Code CLI</strong></summary>
  69. After a release containing `kimi.plugin.json` is published, close other Kimi sessions and install it in a fresh Kimi Code CLI session:
  70. ```text
  71. /plugins install https://github.com/michael-denyer/pstack-claude
  72. /reload
  73. ```
  74. To test an unreleased checkout, use `/plugins install /absolute/path/to/pstack-claude` instead, followed by `/reload`; Kimi copies the whole checkout, including Git metadata and local files, so use a clean, reviewed copy. To update, close other Kimi sessions, reinstall from the same source in a fresh session, and run `/reload`. Invoke a skill as `/skill:pstack:poteto-mode`; see the [Kimi mapping](plugins/pstack/skills/poteto-mode/references/kimi-tools.md) for tool guidance.
  75. </details>
  76. <details>
  77. <summary><strong>Grok Build</strong></summary>
  78. ```shell
  79. git clone https://github.com/michael-denyer/pstack-claude
  80. cd pstack-claude
  81. grok plugin install "$PWD/plugins/pstack" --trust
  82. grok plugin enable pstack
  83. ```
  84. Start a new session and use `/poteto-mode` to load the skill explicitly. To update a local install, quit Grok sessions, inspect `grok plugin details pstack` and back up any edits in the installed copy, pull the checkout, run `grok plugin uninstall pstack --keep-data`, and repeat the last two commands. If pstack was disabled, disable it again before restarting. `grok plugin update` does not refresh a local install.
  85. </details>
  86. <details>
  87. <summary><strong>MiniMax Code</strong></summary>
  88. For a first install, check that `${MINIMAX_DATA_DIR:-$HOME/.minimax}/plugins/pstack` does not already exist. Then run in your terminal:
  89. ```shell
  90. git clone https://github.com/michael-denyer/pstack-claude
  91. cd pstack-claude
  92. mkdir -p "${MINIMAX_DATA_DIR:-$HOME/.minimax}/plugins"
  93. cp -R plugins/pstack "${MINIMAX_DATA_DIR:-$HOME/.minimax}/plugins/pstack"
  94. ```
  95. MiniMax Code loads each directory under `plugins/` in its data directory as a local plugin, and reads pstack through its Claude Code reader with the skills, agents, and routing hook. `mcode plugin list` shows it as `pstack@local`. To update, record its enabled state, quit every `mcode` process, and move `plugins/pstack` to an unused path outside `plugins/`. Run `git pull` and the `cp` line again. Check `mcode plugin list` and restore the previous enabled state if needed.
  96. </details>
  97. <details>
  98. <summary><strong>OpenCode 2</strong></summary>
  99. Clone the repository, then add the absolute path to `plugins/pstack/opencode` to the existing `plugins` array in `~/.config/opencode/opencode.jsonc`. On Windows, use a path such as `C:/Users/name/pstack-claude/plugins/pstack/opencode`. Restart OpenCode after checkout updates.
  100. Alternatively, install, check, or update the native Git package:
  101. ```bash
  102. opencode plugin add 'github:michael-denyer/pstack-claude#main'
  103. opencode plugin check 'github:michael-denyer/pstack-claude#main'
  104. opencode plugin update 'github:michael-denyer/pstack-claude#main'
  105. ```
  106. A commit-pinned reference does not advance. If a check immediately after installation reports no package plugins, wait for the server to load it and check again.
  107. If you previously installed pstack skills into `~/.agents/skills`, inspect the links and remove only those pointing to your pstack checkout before using the plugin.
  108. The plugin registers `pstack-` skill IDs and adds routing in root sessions. If routing is missing, run `opencode api get /api/skill` and check that each `pstack-` path belongs to this plugin. Resolve any conflicting skill before manually invoking that ID. Use `session hook: off` in the OpenCode model sheet to disable routing. To remove the plugin, remove its configured path and restart the service, or use `opencode plugin remove` with the exact Git specifier. OpenCode 1 is unsupported. See the [OpenCode mapping](plugins/pstack/skills/poteto-mode/references/opencode-tools.md).
  109. </details>
  110. <details>
  111. <summary><strong>Antigravity (agy)</strong></summary>
  112. Run in your terminal:
  113. ```shell
  114. git clone https://github.com/michael-denyer/pstack-claude
  115. cd pstack-claude
  116. agy plugin install ./plugins/pstack
  117. ```
  118. This installs the native Antigravity plugin bundle (`skills`, `agents`, and `SessionStart` routing hook) into `~/.gemini/config/plugins/pstack`.
  119. </details>
  120. <a id="other-harnesses"></a>
  121. <details>
  122. <summary><strong>Other harnesses</strong></summary>
  123. Gemini CLI, Prime Agent, and skills-only Codex installs read skills from `~/.agents/skills/`. Run in your terminal:
  124. ```shell
  125. git clone https://github.com/michael-denyer/pstack-claude
  126. cd pstack-claude
  127. mkdir -p ~/.agents/skills
  128. for s in plugins/pstack/skills/*/; do
  129. target=~/.agents/skills/"$(basename "$s")"
  130. test -e "$target" || test -L "$target" || ln -s "$(pwd)/$s" "$target"
  131. done
  132. ```
  133. To update, run `git pull` in the clone, then run the `for` loop again to link skills added since the last run. These installs have no routing hook, so ask for `poteto-mode` by name or add a standing instruction to the harness's instruction file. See [shared installation](docs/reference.md#shared-skills-installation) for per-harness notes and uninstalling.
  134. </details>
  135. ### Configure
  136. pstack provides automatic routing on Claude Code, Codex, GitHub Copilot, Muse, MiniMax Code, Antigravity, Pi, Kimi Code CLI, OMP, and OpenCode 2. The runtimes deliver the instruction at different points: Kimi adds it while the plugin is enabled, OMP adds it before each main-agent turn, and OpenCode adds it at each model step in root sessions. Grok Build exposes a routing hint through a skill description; the model may not follow it. Codex requires hook trust through `/hooks`, and Muse requires `muse plugins approve pstack`. Other harnesses have no automatic routing.
  137. Run `setup-pstack` to turn automatic routing on or off, change model defaults, or set a reasoning effort per role (`arena runners: opus @xhigh, fable @max`). On OMP, the session hook setting applies globally across profiles; on Kimi, enable or disable the plugin to control routing. See the [routing reference](docs/reference.md#automatic-routing).
  138. ## Getting started
  139. ```text
  140. Use poteto-mode to fix the search filter resetting when I change pages.
  141. ```
  142. For a bug, it reproduces the failure, uses `how` and `why` to investigate, delegates the fix, then reruns the failing case. If the fix crosses a function boundary, it brings in `architect` before implementation. You receive the fix and the failing and passing evidence.
  143. A localized bug with a demonstrated cause can use the [focused-fix exception](plugins/pstack/skills/poteto-mode/playbooks/bug-fix.md#focused-fix-exception). One delegate investigates and implements the correction when it preserves existing interfaces and state semantics and has a focused regression check. Reproduction, verification, and required independent review still apply; a small patch alone does not qualify.
  144. [Other playbooks](plugins/pstack/skills/poteto-mode/SKILL.md#playbooks) cover planning, features, refactoring, performance issues, investigations, prototypes, PR maintenance, shipping, and longer projects.
  145. ![poteto-mode on Claude Code, Codex, and Pi turns a request into verified work. Choose a playbook, plan and delegate with architect, arena, or swarm, then review and verify with interrogate, tests, and measurements. Project playbooks customize the workflow, and setup-pstack configures the model and reasoning effort per role. Supporting skills include how, why, and unslop.](assets/pstack-overview.png)
  146. ## Details
  147. - [Skills and slash commands](docs/reference.md#slash-commands)
  148. - [Runtime setup](docs/reference.md#runtime-support)
  149. - [Models and dependencies](docs/reference.md#configuration-and-dependencies)
  150. - [Maintenance and port scope](docs/reference.md#maintenance)
  151. ## Data handling
  152. 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.
  153. This port has no automatic agent-diary reporting or diary opt-in setting. For a local decision trail, ask for [`show-me-your-work`](plugins/pstack/skills/show-me-your-work/SKILL.md). Longer or unattended workflows also invoke it. The trail stays uncommitted by default. If the trail is committed and pushed to a shared PR, anyone with access to the PR can read it.
  154. To share feedback, submit a short, manually reviewed report through [GitHub issues](https://github.com/michael-denyer/pstack-claude/issues). Include the pstack version, runtime, relevant workflow, and observed result. Remove credentials, customer data, private repository links, and sensitive log or configuration values before posting; share a summary instead of raw transcripts.
  155. ## Contributing
  156. Thanks for helping make this port better. Bug reports, documentation fixes, and runtime improvements are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for the checks and where your change belongs. Report vulnerabilities privately as described in [SECURITY.md](SECURITY.md).
  157. To support maintenance of this port, [buy the maintainer a coffee](https://buymeacoffee.com/codenyer).
  158. ## License
  159. This port, including its modifications and additions, is also [MIT-licensed](LICENSE), © 2026 Michael Denyer. Original pstack © 2026 Lauren Tan; imported cursor-team-kit and thermos skills © 2026 Cursor. See [LICENSE-cursor-team-kit](LICENSE-cursor-team-kit), [LICENSE-thermos](LICENSE-thermos), and [NOTICE.md](NOTICE.md).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.