{"_id":"@0xrsydn/pstack-pi","name":"@0xrsydn/pstack-pi","dist-tags":{"latest":"0.15.1"},"versions":{"0.15.1":{"name":"@0xrsydn/pstack-pi","version":"0.15.1","description":"Port of pstack (Lauren Tan's Cursor plugin) to pi: poteto-mode workflows, principle skills, and subagent fan-out with per-role models.","license":"MIT","author":{"name":"Lauren Tan","url":"original pstack"},"repository":{"type":"git","url":"git+https://github.com/cursor/plugins.git","directory":"pstack"},"keywords":["pi-package","pstack","poteto-mode","workflow","principles","subagents"],"pi":{"extensions":["./extensions/subagent/index.ts"],"skills":["./skills"]},"peerDependencies":{"@earendil-works/pi-agent-core":"*","@earendil-works/pi-ai":"*","@earendil-works/pi-coding-agent":"*","@earendil-works/pi-tui":"*","typebox":"*"},"publishConfig":{"access":"public"},"_id":"@0xrsydn/pstack-pi@0.15.1","gitHead":"bbd41ce037debce19e4c5c2f676249ca13a87976","bugs":{"url":"https://github.com/cursor/plugins/issues"},"homepage":"https://github.com/cursor/plugins#readme","_nodeVersion":"22.22.0","_npmVersion":"10.9.4","dist":{"integrity":"sha512-nORJTClVy7lDQzrzMOXgoX6KRmzxVLclwiBRfMfhv6Kg5Bw3uEsrWJPDrCarGW84HlMH5GudrVadaq/f+WDjng==","shasum":"c407cb7914ba8019723ada8f5e9e434c3377c0dc","tarball":"https://registry.npmjs.org/@0xrsydn/pstack-pi/-/pstack-pi-0.15.1.tgz","fileCount":129,"unpackedSize":674631,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIH+DkE8Nrf8+BlvKzTnC1cl47yubvgIJM4DTmSmcHK0CAiEAiWiN4GmDZPHbbPpCsfvBaNeQJNcm2yWu+pwHLgrkwnc="}]},"_npmUser":{"name":"0xrsydn","email":"rasyidanakbarf@gmail.com"},"directories":{},"maintainers":[{"name":"0xrsydn","email":"rasyidanakbarf@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/pstack-pi_0.15.1_1787839971993_0.9970024096381169"},"_hasShrinkwrap":false}},"time":{"created":"2026-08-27T14:12:51.879Z","0.15.1":"2026-08-27T14:12:52.453Z","modified":"2026-08-27T14:12:52.663Z"},"maintainers":[{"name":"0xrsydn","email":"rasyidanakbarf@gmail.com"}],"description":"Port of pstack (Lauren Tan's Cursor plugin) to pi: poteto-mode workflows, principle skills, and subagent fan-out with per-role models.","homepage":"https://github.com/cursor/plugins#readme","keywords":["pi-package","pstack","poteto-mode","workflow","principles","subagents"],"repository":{"type":"git","url":"git+https://github.com/cursor/plugins.git","directory":"pstack"},"author":{"name":"Lauren Tan","url":"original pstack"},"bugs":{"url":"https://github.com/cursor/plugins/issues"},"license":"MIT","readme":"# pstack-pi\n\nA pi port of [pstack](https://github.com/cursor/plugins/tree/main/pstack), Lauren Tan's Cursor plugin. Original content is MIT-licensed (see LICENSE); this port keeps its structure and wording and adapts Cursor-specific mechanics to pi.\n\n> **Acknowledgment:** all skills, workflows, and prose originate from Lauren Tan's [pstack](https://github.com/cursor/plugins). This repository only ports them to pi.\n\n## Quick start\n\n```bash\npi install npm:@0xrsydn/pstack-pi\n```\n\n## What ships\n\n- **`skills/`** — all 45 original workflow and principle skills (`poteto-mode`, `swarm`, `arena`, `interrogate`, `how`, `why`, `reflect`, the `principle-*` set, etc.), rewritten where they referenced Cursor-specific mechanics.\n- **`agents/`** — subagent definitions discovered by the bundled extension: `poteto-agent`, `comment-sicko`, and `general-purpose` (replaces Cursor's built-in `generalPurpose` task agent).\n- **`extensions/subagent/`** — pi's example subagent tool, extended for pstack:\n  - Per-task `model` override (with pstack's `inherit-parent` / `auto` aliases), so one parallel call can mix models.\n  - Per-task `readonly` flag (restricts to `read,grep,find,ls`).\n  - Discovers the bundled `agents/` directory from inside the package. User (`~/.pi/agent/agents/`) and project (`.pi/agents/`) definitions win over bundled ones.\n  - Single, parallel (`tasks[]`), and chain modes are unchanged otherwise.\n\n## Install\n\n```bash\npi install npm:@0xrsydn/pstack-pi        # from npm (recommended, version-pinned)\npi install git:github.com/0xrsydn/pstack-pi   # or from git\n```\n\nAfter installing, confirm resources load with `pi list`.\n\n## Model configuration\n\nRun the `setup-pstack` skill (\"/skill:setup-pstack\", or ask the agent to configure pstack models). It:\n\n1. Detects your models with `pi --list-models`.\n2. Asks which model each role uses (code delegates, judgment/prose, review panels, swarm workers).\n3. Writes `~/.pi/agent/pstack-models.md`.\n\nThe parent agent reads that file before spawning and passes each role's value as the `model` field of its `subagent` task entry. Delete a line to fall back to that skill's inline default; delete the file to fall back everywhere. There is no requirement to run setup — defaults described inline in the skills apply, but they reference placeholder model names from the upstream plugin until you write real ones.\n\n## Adaptations from the original\n\n| Cursor mechanic | pi equivalent |\n| --- | --- |\n| `Task` tool, `subagent_type` | `subagent` tool, `agent` field |\n| `generalPurpose` built-in agent | bundled `general-purpose` agent |\n| Task-level `model` slug | task-level `model` field (`provider/model-id` form) |\n| `run_in_background`, cloud workers | parallel `tasks[]` calls run concurrently with isolated contexts; all local |\n| `environment: \"cloud\"` / cloud VMs | removed; lanes run in worktrees on this machine |\n| `~/.cursor/rules/pstack-models.mdc` | `~/.pi/agent/pstack-models.md` (plain markdown, read before spawns) |\n| `~/.cursor/skills/` paths | `~/.pi/agent/skills/`; project `.cursor/skills/` → `.pi/skills/` |\n| Session transcripts under `~/.cursor/projects/<slug>/agent-transcripts/` | `~/.pi/agent/sessions/<dashed-repo-path>/*.jsonl` |\n| Cursor's built-in `create-skill` / babysit skills | generic authoring guidance; pstack's own playbooks cover these requests |\n| `deslop`, `control-ui`/`control-cli` (`cursor-team-kit`) references | degraded gracefully: steps drop the plugin dependency or drive the surface directly |\n| Bugbot review-bot comments | generalized to any bot reviewer comments |\n| Slash commands like `/bro`, `/why` | `/skill:bro`, `/skill:why` (enable skill commands in settings) |\n\nNot ported:\n\n- **Cursor Cloud Automations** (`automations/benny/`) and the `grokbot` automation-webhook skill — no pi equivalent background-runner target.\n- **`docs/guide/`** — read it [upstream](https://github.com/cursor/plugins/blob/main/pstack/docs/guide/README.md); most prose still applies apart from setup details.\n- Skills that rely on MCP servers (for example parts of `why`) expect you to have equivalent data sources reachable through other tools.\n\n## Requirements\n\n- The bundled extension shells out to the `pi` binary on PATH (subagent tool).\n- Panel/swarm fan-out works best with more than one provider configured.\n","readmeFilename":"README.md","_rev":"1-9cf34441a1e4f49545e0f0ad3baa154f"}