Our take
Newless than six months old and changing fast- Activity
- 81
- Community
- 47
- Issues
- 93
- Pull requests
- 84
+57 stars in the last 26 days
- Merges more pull requests than 96% of the projects we track
- Closes issues faster than 81% of the projects we track
- Releases more often than 79% of the projects we track
GSD Pi is a fast-moving, newly established project with strong recent release and contribution activity, but work is concentrated among a small share of its contributors.
Good fit if
- You want a command-line coding agent that combines project planning, execution, verification, and local project memory.
- Your workflow benefits from worktree-isolated changes and milestone-based progress tracking.
- You can meet its Node.js and Docker requirements and are comfortable adopting an actively changing MIT-licensed project.
Look elsewhere if
- You need a mature project with a longer public track record, since this repository is less than six months old.
- Your team requires development to be broadly distributed across contributors, as activity is concentrated among one contributor.
- Your environment cannot provide Node.js >=22.18.0 or Docker.
All health signals
| Last commit | 2026-10-27 (today) |
|---|---|
| Commits, last 90 days | 100+ |
| Releases, last 12 months | 28 (latest v1.22.0, 2026-10-12) |
| Contributors | 37 (top contributor: 84% of commits) |
| Issues closed, last 90 days | 42+ (typically closed in 0 days) |
| Pull requests merged, last 90 days | 94 (typically merged in 0 days) |
| Project age | 5 months |
Checked on 2026-10-28 with the GitHub API.
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
1,351Forks
115Change since Nov 1, 2026: +3 stars·0 forks
Overview
GSD Pi is a local-first coding agent built in TypeScript for Node.js. It brings planning, implementation, verification, and progress tracking into a command-line workflow, helping agents handle extended project work without losing sight of requirements and decisions. You can use its terminal interface or launch its web surface with gsd --web.
Rather than treating a coding task as a single prompt, GSD organizes work into milestones, slices, and tasks, then records project context and validation evidence locally. Its workflows combine an agent, Git worktrees, and extension points for tools and interfaces.
Key Features
- Plan work as milestones, slices, and tasks, with an auto mode to plan, implement, verify, and advance.
- Run guided or quick coding sessions from the terminal, including a JSON-output mode for scripted quick tasks.
- Isolate implementation work in Git worktrees while keeping the main checkout available for review.
- Store requirements, decisions, runtime notes, plans, summaries, and validation evidence under
.gsd/. - Route work through multiple model providers, including API, OAuth, and external CLI providers.
- Extend the system with project-specific commands, tools, skills, and UI integrations.
- Use a terminal interface by default, or launch the web interface with
gsd --web.
Use Cases
- A developer wants an agent to carry a feature through planning, implementation, and verification while keeping the work organized into reviewable stages.
- A team needs coding work isolated from its main checkout, with Git worktrees and recorded validation results supporting review.
- A project maintainer wants local records of requirements, decisions, and runtime notes to provide continuity across coding sessions.
- A developer building automation wants to run a quick task non-interactively and consume its structured JSON result and exit code.
What you need
Detected in the repository
- Node.js >=22.18.0 (from package.json)
- A Dockerfile, so it can run in a container
- A test suite and automated checks on GitHub Actions
License in plain words
MITpermissive
- Commercial use: yes
- Modify and redistribute: yes
- You must keep: the copyright and license notice
- Share your changes: no
A summary, not legal advice: the LICENSE file is what applies.
Getting Started
Install and run the guided setup:
npx @opengsd/gsd-pi@latest
Then start GSD with gsd in a project directory. See the README for provider setup, migration, and development instructions.
Alternatives
- spec-kitty: Spec Kitty uses a Python CLI and Git-managed work packages, reviews, and merge decisions, while gsd-pi is a TypeScript agent with milestone workflows and project memory.
- aidlc-workflows: AI-DLC provides harness-neutral delivery workflows with decision and approval gates, while gsd-pi is a local-first CLI with project memory and Git worktree automation.
| Project | Language | License | Stars | Status |
|---|---|---|---|---|
| gsd-pi | TypeScript | MIT | 1.3k | New |
| spec-kitty | Python | MIT | 1.7k | Active |
| aidlc-workflows | TypeScript | MIT-0 | 5.4k | Active |
Considerations
The repository is new and changing quickly, so workflows and interfaces may evolve as the project develops. Recent commits and releases are frequent, and issue and pull request handling is active, but measured contributor activity is highly concentrated. The project requires Node.js >=22.18.0 and Docker. Its MIT license permits broad use, subject to the license terms.
Found this useful?
Share it with someone who would like gsd-pi.