GSD 2

The evolution of Get Shit Done — now a real coding agent.

The original GSD went viral as a prompt framework for Claude Code. It worked, but it was fighting the tool — injecting prompts through slash commands, hoping the LLM would follow instructions, with no actual control over context windows, sessions, or execution.

This version is different. GSD is now a standalone CLI built on the Pi SDK, which gives it direct TypeScript access to the agent harness itself. That means GSD can actually do what v1 could only ask the LLM to do: clear context between tasks, inject exactly the right files at dispatch time, manage git branches, track cost and tokens, detect stuck loops, recover from crashes, and auto-advance through an entire milestone without human intervention.

One command. Walk away. Come back to a built project with clean git history.

npm install -g gsd-pi

Documentation

Full documentation is available in the docs/ directory:

• Getting Started — install, first run, basic usage
• Auto Mode — autonomous execution deep-dive
• Configuration — all preferences, models, git, and hooks
• Token Optimization — profiles, context compression, complexity routing (v2.17)
• Cost Management — budgets, tracking, projections
• Git Strategy — worktree isolation, branching, merge behavior
• Working in Teams — unique IDs, shared artifacts
• Skills — bundled skills, discovery, custom authoring
• Commands Reference — all commands and keyboard shortcuts
• Architecture — system design and dispatch pipeline
• Troubleshooting — common issues, doctor, recovery
• Migration from v1 — .planning → .gsd migration

What Changed From v1

The original GSD was a collection of markdown prompts installed into ~/.claude/commands/. It relied entirely on the LLM reading those prompts and doing the right thing. That worked surprisingly well — but it had hard limits:

• No context control. The LLM accumulated garbage over a long session. Quality degraded.
• No real automation. "Auto mode" was the LLM calling itself in a loop, burning context on orchestration overhead.
• No crash recovery. If the session died mid-task, you started over.
• No observability. No cost tracking, no progress dashboard, no stuck detection.

GSD v2 solves all of these because it's not a prompt framework anymore — it's a TypeScript application that controls the agent session.

| | v1 (Prompt Framework) | v2 (Agent Application) | | -------------------- | ---------------------------- | ------------------------------------------