@whamp/pi-pstack

pstack for Pi: rigorous agent workflows you can parallelize with confidence. Ported from the Cursor pstack plugin.

If you want to go fast, go deep first. pstack helps you write less, but higher quality code. It gives you fearless parallelism: when an agent goes deep and writes good, verifiable code, you can parallelize with confidence. Start multiple agents with poteto-mode and trust they will apply rigorous engineering principles to their work.

Install

pi install npm:@whamp/pi-pstack

Or install from the repository, which is the source of truth for this port:

git clone https://github.com/Whamp/pi-extensions.git ~/projects/pi-extensions
cd ~/projects/pi-extensions
pnpm install --frozen-lockfile
pi install ~/projects/pi-extensions/packages/pi-pstack

This package is ported from the Cursor pstack plugin by Lauren Tan (LICENSE).

Requires pi-subagents for the poteto-agent, comment-sicko, and workflow fan-outs (how, why, arena, swarm, interrogate, reflect).

Get started

1. Run /setup-pstack once to pick which models each role uses (optional; every role inherits the parent session model otherwise).
2. Use /poteto-mode for sticky Poteto Mode. It stays on until /poteto-mode off. /skill:poteto-mode also enables it.
3. Run /pstack off to hide even the four Discoverable skills (how, why, unslop, typescript-best-practices) from the Skill catalog. Off persists in ~/.pi/agent/pstack/models.json. /skill:<name> keeps working. /pstack on restores those four, not all 47.

That is it. The other skills are Hidden; the mode skill uses them as needed.

What you get

• 47 skills, including:
  • poteto-mode: the main entry point. Reads your request, matches one of 23 playbooks (bug fix, perf, feature, refactoring, investigation, shipping, orchestrate, autopilot, and more), copies its steps in verbatim, and routes to the other skills as steps fire. Orchestrate refills one shared worker-and-verifier window as each child settles.
  • Workflow skills: how, why, recall, blast-radius, architect, arena, swarm, interrogate, reflect, teach, tdd, no-comments, unslop, deslop, bro, figure-it-out, show-me-your-work, create-verification-skill, maintain-verification-skill, automate-me, technical-writing, typescript-best-practices.
  • 23 principle skills (principle-laziness-protocol, principle-model-the-domain, principle-prove-it-works, ...), one rule each, indexed inline by poteto-mode.
• ask_user_question: one structured preference question with 2-6 listed options. The user can pick those or type a different answer.
• 2 subagents (loaded by pi-subagents):
  • poteto-agent: runs poteto's style end to end. Reads poteto-mode in full before any work.
  • comment-sicko: read-only comment reviewer that savors deletion. Usually invoked through the no-comments skill.
• Bundled scripts: poteto-mode/scripts/ ships the orch coordination CLI (orchestrate playbook) and the watch-pr watcher (babysit playbook). Both run under bun.

Model roles

Per-role model choices live in ~/.pi/agent/pstack/models.json. Run /setup-pstack to write it. The 22 role names and cardinalities are in skills/setup-pstack/references/MODEL-ROLES.md. The extension injects the role table only when a role has a real model slug. Default inherit-all injects nothing. inherit-parent or auto runs on the parent session model.

Differences from the Cursor plugin

• Hidden skills set disable-model-invocation: true, so they stay out of the Skill catalog. /skill:name still loads the Skill body. The four Discoverable skills are how, why, unslop, and typescript-best-practices.
• Slash commands are /skill:<name> instead of /name.
• Subagent delegation uses pi-subagents. Launch one child with subagent({ action: "execute", input: { agent, task } }). Set input.async: true for background work. Run parallel or dependent children in one workflowScript with stable keys. This package does not ship the subagent tool.
• Session transcripts live under ~/.pi/agent/sessions/ instead of ~/.cursor/projects/. The active file is $PI_SESSION_FILE. Files are grouped by cwd slug (--<cwd>--, absolute cwd with / replaced by -).
• The benny automation pack is not ported; it depends on Cursor automations. Model roles live in ~/.pi/agent/pstack/models.json, written by /setup-pstack and injected only when a role has a real model slug.
• make-bot-ui is not ported. It is Cursor Grok Bot / routine webhook UI.

License

MIT