pstack for Codex

This repository ports pstack from Cursor to Codex.

The engineering principles and playbooks remain pstack's. The runtime integration is native Codex:

• Codex collaboration agents instead of Cursor Task and poteto-agent
• inherited session runtime instead of hard-coded model slugs
• Codex memory and task history instead of Cursor transcript paths
• Codex browser, computer-use, GitHub, and automation tools
• .codex/skills for global and project-local skills

The port currently contains 40 skills, including poteto-mode, its playbooks, the workflow skills, and 21 engineering principles.

Install

git clone https://github.com/HustleCoding/pstack-codex.git
cd pstack-codex
./scripts/install.sh

The installer backs up any same-named global skills before writing to ~/.codex/skills. It does not touch unrelated skills.

Restart Codex or start a new task after installation so the refreshed skill catalog loads.

Configure

Ask Codex:

Use setup-pstack and configure pstack with your recommended Codex settings.

The setup skill writes ~/.codex/pstack/config.md. Codex collaboration agents currently inherit the session runtime, so the setup controls fan-out, isolation, memory, verification, and publication policy rather than assigning model slugs.

Use

Start rigorous work with:

Use poteto-mode. Diagnose this bug, prove the root cause, fix it, and verify on the real surface.

You can also invoke focused skills such as how, why, architect, arena, interrogate, blast-radius, tdd, and teach.

Check upstream

./scripts/check-upstream.sh

The script compares this port's recorded upstream commit with the current cursor/plugins main branch. It reports pstack changes without modifying the port.

After porting an upstream update, replace UPSTREAM_COMMIT with the reviewed upstream commit and run:

./scripts/audit.py

Attribution

pstack was created by Lauren Tan and is published in the Cursor plugins repository under the MIT License. This repository is an independent Codex port and is not affiliated with Cursor or OpenAI.