oh-my-pstack

Portable, rigorous engineering workflows for OMP, Pi, OpenCode, Claude Code, Codex, and other hosts that support the Agent Skills layout.

oh-my-pstack is a universal port of the original Cursor pstack. It keeps the upstream workflow catalog, playbooks, principles, references, and verification scripts while replacing Cursor-only runtime assumptions with a host-neutral adapter.

What is included

• 44 upstream pstack skills and their supporting references.
• Benny's three fail-closed issue-triage/reproduction skills.
• poteto-mode for routing work through the right playbook.
• pstack-pi for translating roles, delegation, models, transcripts, questions, and long-running work to the active host.
• Native package metadata for OMP/Pi, Claude Code, and Codex, plus OpenCode setup guidance.
• Daily upstream synchronization that opens a verified pull request.

The original Cursor repository is the content authority. The dsebban repository was used only as an early structural example; it is not an upstream source.

Install

Pi

Install the public GitHub package:

pi install https://github.com/shrimpwtf/oh-my-pstack

Start Pi in your project:

pi

Use pi list to confirm the package. Use pi update --extensions to reconcile installed Git packages, or pi remove https://github.com/shrimpwtf/oh-my-pstack to remove it. Pi packages run with full system access; review the source before installing and keep the package pinned or update it deliberately.

For parallel workers and per-role model assignments, install Pi's delegation extension too:

pi install npm:pi-subagents

Restart Pi and run /subagents-doctor. The extension provides the subagent tool and built-in scout, researcher, worker, reviewer, oracle, and delegate agents. It is separate from pstack because native Pi does not include subagents.

OMP

Install from GitHub:

omp install https://github.com/shrimpwtf/oh-my-pstack

For local development, load the checkout directly:

omp --plugin-dir /path/to/oh-my-pstack

OpenCode

OpenCode natively loads Agent Skills from .opencode/skills/ in a project or ~/.config/opencode/skills/ globally. Install the repository and copy its skills into one of those discovery directories:

git clone https://github.com/shrimpwtf/oh-my-pstack.git \
  ~/.local/share/oh-my-pstack
mkdir -p ~/.config/opencode/skills
cp -R ~/.local/share/oh-my-pstack/skills/. ~/.config/opencode/skills/

Start OpenCode in your project. The skills appear through OpenCode's native skill tool; ask it to load setup-pstack or poteto-mode by name. To update, pull the repository and repeat the copy step:

git -C ~/.local/share/oh-my-pstack pull --ff-only
cp -R ~/.local/share/oh-my-pstack/skills/. ~/.config/opencode/skills/

For project-local installation, use .opencode/skills/ instead:

git clone https://github.com/shrimpwtf/oh-my-pstack.git .pstack-source
mkdir -p .opencode/skills
cp -R .pstack-source/skills/. .opencode/skills/

OpenCode already provides primary and subagents. Configure their models through your normal opencode.json or opencode.jsonc settings, then ask setup-pstack to map pstack roles to the agents your OpenCode installation exposes.

Claude Code and Codex

Clone or download the repository, then add it through the host's local plugin workflow. Claude Code reads .claude-plugin/plugin.json; Codex reads .codex-plugin/plugin.json. If plugin installation is unavailable, point the host's Agent Skills configuration at the repository's skills/ directory.

Quick start

Start substantial work with poteto-mode. Use pstack-pi when a workflow needs delegation or host-specific lifecycle behavior.

All hosts share the same skill content. The runtime adapter maps canonical pstack roles to the capabilities actually exposed by the host. Missing integrations are reported honestly and fail closed; for example, Benny requires an available Slack/tracker/control adapter rather than pretending those tools exist.

First-time setup

After installing, start a fresh agent session in the project you want to work on. Run the setup skill once:

$setup-pstack

It detects the roles and models your host actually exposes, lets you choose the defaults for implementation and review work when the host supports per-child model selection. On a task-capable host, it writes concrete provider/model-id assignments to .pstack/config.md (or to $PSTACK_CONFIG when set). Native Pi can list and switch the single active model, but it does not include subagents. Install pi-subagents, restart Pi, and run /subagents-doctor before setup if you want role assignments. Setup then writes the pstack role map and Pi's subagents.agentOverrides with concrete model IDs. Without the extension, setup reports the limitation instead of pretending that role assignments are active. Switch Pi's single active model with /model or pi --model provider/model-id.

Then route your first real task through the main workflow:

$poteto-mode add a small feature and prove it works end to end

The setup skill may offer to create a project verification skill when the project has no existing way to exercise the real application. Accept that offer when you want repeatable behavioral proof; otherwise setup finishes without changing the project. Read skills/setup-pstack/SKILL.md for the complete setup contract.

Automatic upstream updates

.github/workflows/upstream-sync.yml checks the original pstack main branch every day at 04:17 UTC and can also be started manually. The pinned baseline lives in upstream.lock.json.

The updater:

1. Fetches the latest upstream revision.
2. Normalizes known Cursor runtime bindings for portable hosts.
3. Updates only upstream-owned files.
4. Preserves OMP adapters and protected portability adaptations.
5. Stops before writing if an adapted file changed upstream.
6. Runs verification, updater tests, Bun tests, and strict TypeScript checking.
7. Opens a pull request only after those checks pass.

Run it locally:

npm run sync:check
npm run sync:apply -- --dry-run
npm run sync:apply

Protected adaptation changes require a human merge decision. The updater never silently overwrites them.

Development and verification

npm run verify
npm run test:sync
bun install --cwd skills/poteto-mode/scripts --frozen-lockfile
bun test orch watch-pr
bunx tsc --project skills/poteto-mode/scripts/watch-pr/tsconfig.json --noEmit --strict

npm run verify checks skill inventory, frontmatter, local references, manifests, the upstream lock, and forbidden vendor-specific runtime bindings.

Host contract

Read skills/pstack-pi/references/runtime.md before adapting a workflow to a new agent host. It defines canonical roles, capability mapping, configuration paths, transcript handling, interaction fallbacks, and verification ownership.

License and attribution

MIT. See LICENSE and THIRD_PARTY_NOTICES.md.

The pstack-derived material is adapted from Lauren Tan's original work in cursor/plugins. See THIRD_PARTY_NOTICES.md for attribution and license text.