pi-gsd-redux

Pi adapter for official Open GSD without forking workflows

Packages

Package details

extensionprompt

Install pi-gsd-redux from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:pi-gsd-redux

Package: pi-gsd-redux
Version: 0.1.0
Published: May 28, 2026
Downloads: not available
Author: noirbright
License: MIT
Types: extension, prompt
Size: 743.6 KB
Dependencies: 2 dependencies · 0 peers

Pi manifest JSON

{
  "extensions": [
    "./dist/extension.js"
  ],
  "prompts": [
    "./generated/prompts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-gsd-redux

Pi adapter for official Open GSD (@opengsd/get-shit-done-redux).

This package keeps official GSD as canonical. It generates Pi prompt templates and Pi-compatible GSD agent definitions from the installed official package.

Install

Install this package as a Pi package, then install pi-subagents as a Pi package so the subagent tool is available:

pi install npm:pi-gsd-redux
pi install npm:pi-subagents
npx pi-gsd-redux sync-agents --scope user

If you want the helper CLI available without npx, install it globally too:

npm install -g pi-gsd-redux
pi-gsd-redux sync-agents --scope user

For local development from this repository:

npm install
npm run build
node dist/cli.js generate --cwd .
node dist/cli.js sync-agents --scope user
pi install -l .
pi install npm:pi-subagents

Generate Official Resources

npm run build
node dist/cli.js generate --cwd .

This writes:

generated/prompts/ for Pi prompt templates such as /gsd-plan-phase
generated/agents/ for Pi-compatible GSD agent definitions

Sync GSD Agents For pi-subagents

Project-local sync is recommended:

npx pi-gsd-redux sync-agents --scope project

This writes generated GSD agents into .pi/agents/, where pi-subagents can discover them.

User-level sync is also supported when you want the same GSD agents available across projects:

npx pi-gsd-redux sync-agents --scope user

Safety behavior:

pi-gsd-redux only writes official gsd-*.md agent files.
Existing files without the pi-gsd generated agent marker are not overwritten.
Extra user files are not deleted.

Doctor

npx pi-gsd-redux doctor

Doctor checks official package resolution, pi-subagents dependency resolution, and generated prompt drift.

To also check generated agents and project .pi/agents sync status:

npx pi-gsd-redux doctor --agents

For user-level synced agents:

npx pi-gsd-redux doctor --agents --scope user

If project agents have not been synced yet, this check reports missing synced agents. Run npx pi-gsd-redux sync-agents --scope project when you want the project-local .pi/agents files materialized.

Update Official GSD

npm update @opengsd/get-shit-done-redux
npm run build
node dist/cli.js generate --cwd .
node dist/cli.js sync-agents --scope project
npm run check