explaingit

gsd-build/gsd-2

7,438TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

A CLI tool that runs an AI coding agent autonomously on your project, working through a structured task list, managing git branches, tracking token usage, and recovering from crashes, all without you sitting at the keyboard.

Mindmap

mindmap
  root((gsd-2))
    What it does
      Runs AI agents autonomously
      Works through task list
      Commits changes to git
    Session control
      Context management
      Token usage tracking
      Loop detection
      Crash recovery
    Workflow
      Milestones and slices
      Per-milestone branching
      Auto merge on complete
    Setup
      Global npm install
      macOS Linux Windows
      Terminal dashboard
Click or tap to explore — scroll the page freely

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

Things people build with this

USE CASE 1

Set up a multi-task coding roadmap and let an AI agent build features automatically while you step away

USE CASE 2

Monitor an autonomous AI coding session with a real-time dashboard showing task progress and token costs

USE CASE 3

Resume a crashed AI coding session from the exact task where it failed using built-in recovery

Tech stack

TypeScriptNode.js

Getting it running

Difficulty · moderate Time to first run · 30min

Requires Claude Code and an active AI API subscription, the agent controls the session externally rather than running inside the AI.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

GSD 2 is a command-line tool that runs an AI coding agent on your software project and lets it work through a long list of tasks without you sitting at the keyboard. You describe what you want built as a structured plan (the project calls this a roadmap of milestones and slices), then run one command and walk away. The agent works through each task, commits its changes to git as it goes, and stops when the plan is done. The earlier version of this project was a prompt framework that gave instructions to Claude Code, asking the AI to follow certain habits. This version is different: it sits outside the AI and directly controls how the session runs. It manages which files are loaded into the AI's context for each task, clears the context between tasks to avoid confusion, tracks how many tokens and dollars the session has spent, detects when the agent appears stuck in a loop, and recovers from crashes. The README describes this as going from asking the AI to do things to actually controlling how it runs. The tool handles git branching automatically during a session. Each milestone or unit of work gets its own branch, and completed work is merged as the session progresses, leaving a clean history. If a session crashes mid-task, GSD 2 can resume from where it left off, detecting leftover lock files and unregistered milestones and reconciling them before continuing. There is also a built-in terminal dashboard that shows what the agent is doing in real time, including progress through the roadmap, token usage, and whether any recovery steps are running. The tool installs as a global npm package with one command and works on macOS, Linux, and Windows. GSD 2 is written in TypeScript and is open source under the MIT license. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
I want to use gsd-build/gsd-2 to run Claude Code autonomously through a list of tasks on my project. How do I structure a roadmap file with milestones and slices, and what command do I run to start the session?
Prompt 2
Using GSD 2, create a roadmap for building a REST API with authentication, include 3 milestones: project setup, auth endpoints, and CRUD endpoints with database models.
Prompt 3
GSD 2 reports my session is stuck in a loop. How does it detect loops, and what recovery steps does it take automatically before stopping?
Prompt 4
How do I install GSD 2 as a global npm package on macOS and wire it up to control an AI coding agent on an existing TypeScript project?
Open on GitHub → Explain another repo

← gsd-build on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.