← all repositories
open-gsd/gsd-pi

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.

gsd-pi
Collecting fresh signals — velocity needs a few days of history.
collecting data…
star history

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.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.