explaingit

open-gsd/gsd-pi

Analysis updated 2026-05-18

94TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

A CLI tool that helps developers plan and execute coding projects with an AI agent, tracking milestones and tasks using isolated Git worktrees.

Mindmap

mindmap
  root((GSD Pi))
    What it does
      AI coding agent
      Project planning
      Git worktrees
    Tech stack
      TypeScript
      Node.js
      VS Code extension
    Use cases
      Plan milestones
      Long coding sessions
      Isolated work
    Audience
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Plan a coding project into milestones, slices, and tasks with AI assistance

USE CASE 2

Run long AI coding sessions that keep context on what is done and pending

USE CASE 3

Use Git worktrees to isolate AI-generated changes from the main branch

USE CASE 4

Review AI-generated plans, validation notes, and reports before merging work

What is it built with?

TypeScriptNode.jsGitVS Code

How does it compare?

open-gsd/gsd-piveryyoldman/metamask-openclawdataants-ai/cutscript
Stars949493
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires connecting to an external AI model provider during setup.

MIT lets you use, modify, and distribute the software freely, including commercially, as long as you keep the copyright notice.

In plain English

GSD Pi is a command-line tool that helps developers plan and carry out software projects with the assistance of an AI coding agent. The name stands for Get Stuff Done. You install it globally from npm, open a terminal, type gsd, and it walks you through a setup that connects to a model provider of your choice. From that point on, you work with it through a session in your terminal. The core idea is that the tool keeps track of a project at multiple levels of detail at once. It breaks work into milestones, slices, and tasks, and stores that structure in a local folder called .gsd inside your project. When you run a coding session, the agent has access to the current plan, the project state, and verification steps, so it can work for longer stretches without losing context about what has already been done and what still needs to happen. GSD Pi uses a Git feature called worktrees to keep implementation work in its own isolated copy of the repository while the main branch stays clean. After the work is done, the tool helps bring the two together. It also produces written artifacts as it works: plans, validation notes, summaries, and reports that you can review without digging through raw code. The repository is a TypeScript monorepo with separate packages for the CLI, a terminal interface, a desktop studio application, a VS Code extension, and a web UI. The README notes that this is a fresh 1.0.0 baseline and that older release history was archived to give reviewers a clean starting point. If you previously installed an older unscoped version of the package, the README includes specific migration commands for Mac, Linux, and Windows to remove the old binary and install the new scoped package correctly. After migration, upgrades use a single gsd upgrade command. The license is MIT.

Copy-paste prompts

Prompt 1
Help me install GSD Pi globally and connect it to my preferred AI model provider
Prompt 2
Walk me through breaking my project into milestones, slices, and tasks using GSD Pi
Prompt 3
Explain how GSD Pi uses Git worktrees to isolate AI coding sessions
Prompt 4
Show me how to migrate from an older unscoped GSD Pi install to the new scoped package

Frequently asked questions

What is gsd-pi?

A CLI tool that helps developers plan and execute coding projects with an AI agent, tracking milestones and tasks using isolated Git worktrees.

What language is gsd-pi written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Git.

What license does gsd-pi use?

MIT lets you use, modify, and distribute the software freely, including commercially, as long as you keep the copyright notice.

How hard is gsd-pi to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is gsd-pi for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.