GSD Revamp is a local-first coding agent for planning, implementing, verifying, and tracking software work from the command line.

This project is a standalone fork of GSD Pi. It keeps the practical GSD workflow, but moves the product direction toward a smaller, cleaner, and easier-to-maintain runtime.

The command remains gsd, and the in-session workflow command remains /gsd.

Questions, ideas, or feedback are welcome on Discord.

GSD Revamp is built around a few constraints:

• Keep the workflow local-first and project-owned.
• Keep the runtime lightweight, explicit, and understandable.
• Prefer simple primitives over broad platform expansion.
• Avoid adding systems that make the project grow harder to reason about over time.
• Preserve the GSD workflow shape: milestones, slices, tasks, verification, and durable project state.
• Treat generated planning artifacts as project records, not hidden service state.

This is not a cosmetic rename of GSD Pi. Active development should treat gsd-revamp as its own product line.

The active baseline starts at the gsd-revamp 1.0.x line; see npm for the latest published version.

Older upstream history may exist for traceability, but this repository should be reviewed and released from the gsd-revamp baseline forward.

Install from npm:

npm install -g gsd-revamp@latest

Run:

gsd

Source: qdzsh/gsd-revamp.

If you previously installed @opengsd/gsd-pi, remove it first so the old global binary does not shadow the new package.

macOS / Linux:

npm uninstall -g @opengsd/gsd-pi
rm -f ~/.gsd/.update-check ~/.gsd/agent/managed-resources.json
npm install -g gsd-revamp@latest
which gsd
gsd --version

Windows PowerShell:

npm uninstall -g @opengsd/gsd-pi
Remove-Item "$env:USERPROFILE\.gsd\.update-check" -Force -ErrorAction SilentlyContinue
Remove-Item "$env:USERPROFILE\.gsd\agent\managed-resources.json" -Force -ErrorAction SilentlyContinue
npm install -g gsd-revamp@latest
where.exe gsd
gsd --version

Routine upgrades use:

gsd upgrade

Start GSD Revamp from your shell:

gsd

Then use slash commands inside the session:

/gsd setup
/gsd auto
/gsd quick "Describe the task"
/gsd status

GSD Revamp stores project planning and runtime state in .gsd/.

• Plans work into milestones, slices, and tasks.
• Runs coding sessions with project context and verification steps.
• Uses Git worktrees to isolate implementation work.
• Tracks project state in a local database with markdown projections for review.
• Supports provider integrations without making the workflow dependent on a hosted service.
• Produces artifacts such as plans, summaries, validation notes, and reports.

npm ci
npm run build
npm test

For faster local checks:

npm run test:compile
npm run test:unit:compiled
npm run test:packages:compiled

Before opening a pull request, run:

npm run verify:fast
npm run verify:pr

The active public baseline starts at the gsd-revamp 1.0.x line; see npm for the latest published version.

Release notes should describe changes from the gsd-revamp baseline forward. Historical upstream refs are useful for auditing, but they are not the product narrative for this fork.

MIT