open-gsd/gsd-pi

A powerful meta-prompting, context engineering and spec-driven development system that enables agents to work for long periods of time autonomously without losing track of the big picture

What is GSD Pi?

GSD Pi (short for Git‑aware Software Development Pi) is a local‑first AI coding assistant that lives in your terminal (or optional web UI). It helps you move a software idea through the whole development cycle:

Planning – break a project into milestones, slices and tasks.
Implementation – generate code with a large‑language‑model (LLM) while keeping the full project context.
Verification – run automated checks and capture validation evidence.
Tracking – store all plans, notes, summaries and verification results in a hidden .gsd/ folder.
Git worktree automation – isolate the generated work in a separate Git worktree so the main branch stays clean and review‑ready.

The tool is designed for developers who want an AI‑driven “agent” that can be invoked from the command line, yet keeps everything offline‑friendly (all state lives on your machine) and extensible via community extensions.

Core Features (as described in the README)

Feature	What it does
Guided terminal agent	Run `gsd` to start an interactive session, configure LLM providers, and launch coding or quick‑task modes directly from the shell.
Autonomous project workflow	Define milestones/slices/tasks; the auto mode can plan, code, verify and advance the work without further prompts.
Worktree‑aware Git automation	Uses Git worktrees to keep generated code isolated while preserving a clean, reviewable main checkout.
Local project memory	All project‑specific data (requirements, decisions, plans, validation notes) are stored under `.gsd/` and are git‑ignored by default.
Multi‑provider model routing	Works with any model you already have – API keys, OAuth, or CLI‑based providers such as Claude Code or Cursor Agent.
Extension surface	Projects can add custom commands, tools, or UI integrations via bundled or community extensions.
Terminal & web surfaces	Default TUI; launch a web UI with `gsd --web` for a visual control plane.

Quick‑Start Flow (from the README)

Install – the recommended one‑liner is:
```
npx @opengsd/gsd-pi@latest
```
(or npm install -g @opengsd/gsd-pi for a global install).
Run the agent:
```
gsd
```
Follow the guided setup to pick a model provider (e.g., Cursor Agent, Claude, etc.).
Start a session – inside the interactive UI you can issue slash commands such as:
- /gsd config – change settings
- /gsd auto – let the agent run the full autonomous workflow
- /gsd quick "Describe the task" – a one‑off coding request
- /gsd status – view current progress
Non‑interactive usage – for scripts you can call:
```
gsd quick --output-format json "Describe the task"
```
which returns a structured JSON result and a meaningful exit code.

Who Might Use GSD Pi?

Solo developers who want an AI partner to keep their work organized and to automate repetitive coding/verification steps.
Small teams that prefer a local, self‑hosted assistant rather than a cloud‑only service.
Open‑source maintainers looking to embed AI‑driven planning and code generation into their repo workflows.
Tool builders who can extend GSD Pi with custom commands or UI integrations via the provided extension surface.

Installation & Upgrade Details

Guided installer (npx @opengsd/gsd-pi@latest) walks you through configuration and creates the gsd binary.
Upgrade is a single command: gsd upgrade (or reinstall via npx).
Migration instructions are provided for users moving from the older unscoped gsd-pi package.
Uninstall removes the global package and the ~/.gsd state directory.

Development & Community

The repo uses a pnpm monorepo layout (src/, packages/, native/, web/).
Build/test commands: pnpm install --frozen-lockfile, pnpm run build, pnpm test.
Contribution workflow includes fast local verification scripts (pnpm run verify:*).
Community support is available on a Discord server (link in README).

License

MIT – free for personal, academic, or commercial use.

Bottom line: GSD Pi is a genuine, actively maintained AI‑powered coding agent that lives on your machine, integrates tightly with Git, and offers both terminal and web interfaces for end‑to‑end project development.