Terminal agent that plans, codes, and verifies in Git worktrees
It keeps long-running coding agents on track by giving them a local project memory, structured workflows, and isolated Git worktrees.

What it does
GSD Pi is a local-first command-line agent that handles the full project lifecycle—planning, implementing, verifying, and tracking—without leaving your terminal. It breaks work into milestones, slices, and tasks, then runs autonomous coding sessions while keeping all project state, decisions, and validation evidence in a local .gsd/ directory. A web UI is available when a visual control plane is preferable to the default TUI.
The interesting bit
The agent uses Git worktrees to isolate implementation branches from the main checkout, preserving a clean, reviewable main branch while the agent experiments. It also routes requests across multiple model providers—including external CLIs like Claude Code and Cursor Agent—so you are not locked into a single vendor.
Key highlights
- Autonomous workflow engine that plans, implements, verifies, and advances through milestones.
- Worktree-aware Git automation that isolates implementation work from the main checkout.
- Local project memory stored under
.gsd/with markdown projections for human review. - Multi-provider model routing supporting API keys, OAuth, and external CLI providers.
- Extension surface for project-specific commands, tools, skills, and UI integrations.
Verdict
Developers juggling long-running agent sessions or struggling with branch hygiene will find the structured workflow and worktree isolation useful. If you prefer lightweight, single-shot code generation without project tracking, this will feel like overkill.
Frequently asked
- What is open-gsd/gsd-pi?
- It keeps long-running coding agents on track by giving them a local project memory, structured workflows, and isolated Git worktrees.
- Is gsd-pi open source?
- Yes — open-gsd/gsd-pi is open source, released under the MIT license.
- What language is gsd-pi written in?
- open-gsd/gsd-pi is primarily written in TypeScript.
- How popular is gsd-pi?
- open-gsd/gsd-pi has 1k stars on GitHub.
- Where can I find gsd-pi?
- open-gsd/gsd-pi is on GitHub at https://github.com/open-gsd/gsd-pi.