# 🥔 potetos-for-everyone
### The Universal pstack & Poteto Mode Workflow for Claude Code, Pi, Cursor, Codex, Gemini & Beyond
**The Modern, Up-to-Date Replacement for `pstack-claude` & `pi-pstack` · 100% Upstream Parity (v0.15.0+) · Zero Dependencies**
[](https://www.npmjs.com/package/potetos-for-everyone)
[](https://github.com/TheOnlyFusionCube/potetos-for-everyone/actions/workflows/ci.yml)
[](https://docs.anthropic.com/en/docs/agents-and-tools/claude-code)
[](https://pi.dev)
[](https://github.com/openai)
[](package.json)
[](LICENSE)
[](https://github.com/TheOnlyFusionCube/potetos-for-everyone/stargazers)
**Claude Code · Pi Agent · Cursor · OpenAI Codex · Google Gemini · GitHub Copilot · Windsurf · Cline · Roo Code · opencode**
> **`potetos-for-everyone`** ports [Lauren Tan's](https://github.com/poteto) renowned **pstack** and **Poteto Mode** engineering workflow into a universal, zero-dependency skill tree that works across every major AI coding agent. It brings disciplined software engineering—reproduce first, minimal blast radius, strict TDD, runtime behavioral verification, and true parallel worktree execution—to Claude Code, Pi, Cursor, Codex, Gemini, Windsurf, Copilot, and beyond.
> [!TIP]
> **Looking to use pstack without Cursor?** You have found the universal, actively maintained solution.
> Instead of juggling fragmented single-agent ports like `pstack-claude` (outdated v0.14.8) or `pi-pstack` (Pi only) or manually copying Markdown files into agent directories, **`potetos-for-everyone`** replaces them all with a single unified codebase:
> - **Claude Code**: Native marketplace plugin (`/plugin marketplace add TheOnlyFusionCube/potetos-for-everyone`) with auto-firing `SessionStart` hooks.
> - **Pi Coding Agent**: Native Pi package (`pi install npm:potetos-for-everyone`).
> - **OpenAI Codex**: Native `.codex-plugin/` prompts (`/poteto-mode`, `/tdd`, `/arena`, `/architect`).
> - **Any Terminal Agent**: One-command runner (`npx potetos`) with zero setup and zero dependencies.
> - **Full Upstream Parity**: 100% synced with upstream **v0.15.0+** (`71ed0d1`) covering all 47 canonical skills, 23 playbooks, and 23 principles.
> [!IMPORTANT]
> **Credit where it belongs:** [pstack](https://github.com/cursor/plugins/tree/main/pstack) and **Poteto Mode** were created by **Lauren Tan ([@poteto](https://github.com/poteto))**. `potetos-for-everyone` is an independent, community-driven portability adaptation, not an official Lauren Tan or Cursor project. Upstream MIT notice and attribution are preserved in [LICENSE](LICENSE) and [NOTICE.md](NOTICE.md).
---
## 🚀 How to Use pstack Without Cursor
### Can You Use pstack Outside of Cursor?
**Yes.** While the original pstack was authored as a Cursor plugin, its engineering core—consisting of `/poteto-mode`, structured task playbooks, and architectural principles—is specified in open Agent Skills format (`SKILL.md`).
**`potetos-for-everyone`** provides the official multi-platform bridge so you can run pstack seamlessly across terminal agents without needing Cursor:
```mermaid
flowchart TD
A[Lauren Tan's pstack v0.15.0+] --> B[potetos-for-everyone Engine]
B --> C["🟣 Claude Code (/plugin install)"]
B --> D["🌸 Pi Agent (pi install)"]
B --> E["🤖 OpenAI Codex (marketplace & prompts)"]
B --> F["⚡ Terminal CLI (npx potetos)"]
B --> G["📦 Vercel skills CLI (skills add)"]
B --> H["🌐 Windsurf / Gemini / Copilot / Cline"]
```
---
### 1. Claude Code (The Modern `pstack-claude` Alternative)
Install directly via Claude Code's native plugin manager:
```shell
/plugin marketplace add TheOnlyFusionCube/potetos-for-everyone
/plugin install pstack@potetos-for-everyone
```
*(Aliases: `/plugin install poteto-mode@potetos-for-everyone` or `/plugin install pstack-claude@potetos-for-everyone`)*
* **Automatic `SessionStart` Hook:** Once installed, Claude Code automatically activates poteto-mode guidance on session startup, `/clear`, and compact, ensuring disciplined engineering for non-trivial code changes.
* **Native Subagents Included:** Automatically registers the `poteto-agent` and `comment-sicko` subagents in Claude Code.
---
### 2. Pi Coding Agent (The Modern `pi-pstack` Alternative)
Install directly using the Pi CLI package manager:
```shell
pi install npm:potetos-for-everyone
# or from GitHub:
pi install git:github.com/TheOnlyFusionCube/potetos-for-everyone
```
* **Pi Package Discovery:** Declares `"pi-package"` and `"pi"` manifests in `package.json` so Pi auto-discovers all 47 skills and slash prompts.
* **Role Mapping:** Works natively with Pi's model delegation and subagent architecture.
* **Usage:** Trigger by typing `/poteto-mode` followed by your task.
---
### 3. OpenAI Codex (Plugin & Prompts)
Codex discovers user skills from `~/.agents/skills/`. Clone or symlink the shared skill tree and Codex command prompts:
```shell
git clone https://github.com/TheOnlyFusionCube/potetos-for-everyone.git
cd potetos-for-everyone
mkdir -p ~/.agents/skills ~/.codex/prompts
for s in skills/*/; do ln -s "$PWD/$s" ~/.agents/skills/"$(basename "$s")"; done
for p in .codex-plugin/prompts/*.md; do ln -s "$PWD/$p" ~/.codex/prompts/"$(basename "$p")"; done
```
* **Slash Commands:** Enables native `/poteto-mode`, `/tdd`, `/arena`, `/architect`, `/babysit`, `/unslop`, and `/why` in Codex.
* **Multi-Agent:** Enable subagents in `~/.codex/config.toml` (`[features] multi_agent = true`).
---
### 4. Zero-Setup Terminal CLI (`npx potetos`)
For all other terminal agents (Windsurf, Copilot, Cline, Roo Code, Gemini CLI, Continue, or generic terminal workflows), run without installing any package dependencies:
```shell
npx potetos
```
*(or `npx potetos-for-everyone`)*
* **Zero Manual File Copying:** Automatically detects your active agent environment and provisions `CLAUDE.md`, `GEMINI.md`, `AGENTS.md`, `.windsurf/`, `.clinerules/`, `.roo/`, and `.continue/` in seconds.
* **Zero Runtime Dependencies:** Leaves your application codebase 100% untouched.
---
### 5. Vercel `skills` CLI (Universal Agent Skills)
Install all 47 canonical skills directly into any project using the standard `skills` CLI:
```shell
npx skills add https://github.com/TheOnlyFusionCube/potetos-for-everyone --skill "*" --yes
```
---
### 6. In Node.js / Web Projects (`devDependency`)
```shell
npm install --save-dev potetos-for-everyone
# or: pnpm add -D potetos-for-everyone
# or: bun add -d potetos-for-everyone
# or: yarn add -D potetos-for-everyone
```
*Automatically installs and updates skills via `postinstall` into `.agents/skills`.*
---