pstack for Claude Code and Codex, with delegated agents running as visible Herdr panes.
This is a fork of michael-denyer/pstack-claude, the Claude Code and Codex port of Lauren Tan's pstack. It has 54 Agent Skills: 31 public skills and 23 principle-* leaves. The skill tree is synced against upstream 12d587d from cursor/plugins/pstack.
Inside Herdr (HERDR_ENV=1), workflows that delegate start real Claude Code or Codex workers in Herdr panes, routed by role. You can watch and answer each worker. Outside Herdr, the plugin behaves like pstack-claude.
/plugin marketplace add TiewKH/pstack-herdr
/plugin install pstack@pstack-claude
codex plugin marketplace add TiewKH/pstack-herdr
codex plugin add pstack@pstack-claudeCodex asks you to trust the routing hook through /hooks before it runs. For skills-only installs and other runtimes, see shared installation.
- Install Herdr, then its integrations for the CLIs you use:
herdr integration install claudeandherdr integration install codex. - Inside Herdr, run
/pstack:setup-pstack. It writes~/.config/pstack-herdr/routes.yaml, which maps each role to a Claude or Codex profile, model, and effort.config/routes.example.yamlshows the format. - Start the coordinator inside Herdr and give
poteto-modea task:
Use poteto-mode to fix the search filter resetting when I change pages.
poteto-mode picks the playbook. For a bug, it reproduces the failure, investigates with how and why, delegates the fix to an implementation worker, and reruns the failing case.
| Layer | Owns |
|---|---|
| pstack skills | decomposition, roles, worktree isolation, synthesis, review, verification |
herdr-dispatch.ts |
pane creation, profile environment, CLI startup, prompt delivery, waiting, output reads, pane cleanup, delegation depth |
herdr-agent-gate.sh |
on Claude Code, denies the native Agent tool inside Herdr and returns the dispatcher command |
| Herdr | panes, agent status, visibility |
| Claude Code, Codex | the delegated work |
Skills keep Claude's Agent vocabulary. herdr-tools.md translates it to dispatcher calls when HERDR_ENV=1, the same way codex-tools.md does for Codex. HERDR.md is the runtime contract: roles, routing, depth limits, isolation, and the dispatcher's lifecycle.
- Skills and slash commands
- Runtime setup
- Models and dependencies
- Maintenance and port scope
- Contributing and security reports
- pstack and Poteto Mode by Lauren Tan (poteto), MIT.
- pstack-claude, the Claude Code and Codex port, by Michael Denyer.
- Imported cursor-team-kit skills by Cursor, MIT.
- Herdr by herdrdev, Apache-2.0. It is an external runtime, not vendored or relicensed here.
This fork's changes are also MIT-licensed. See NOTICE.md and LICENSE-cursor-team-kit.