GSD Pi: Autonomous Coding Agent for Spec-Driven Development

Introduction

GSD Pi is a powerful, local-first coding agent designed for comprehensive project management, from planning to implementation and verification. It leverages meta-prompting, context engineering, and spec-driven development to enable AI agents to work autonomously for extended periods without losing sight of the overall project vision. This system integrates a terminal agent, project workflow tools, worktree-aware Git automation, and optional UI integrations, streamlining the entire development lifecycle.

Why Use and Key Benefits

GSD Pi offers a robust set of features to enhance developer productivity and project autonomy:

• Guided Terminal Agent: Start with gsd to configure providers and run planned or quick coding sessions directly from your shell.
• Autonomous Project Workflow: Break down work into milestones, slices, and tasks, then utilize auto mode to plan, implement, verify, and advance the project automatically.
• Worktree-Aware Git Automation: Maintain isolated implementation work while preserving a clean, reviewable main checkout, ensuring project integrity.
• Local Project Memory: Store all critical project requirements, decisions, runtime notes, generated plans, summaries, and validation evidence securely under .gsd/.
• Multi-Provider Model Routing: Use your team's preferred AI provider, supporting API keys, OAuth providers, and external CLI providers like Claude Code and Cursor Agent.
• Extension Surface: Extend GSD Pi's capabilities by adding project-specific commands, tools, skills, and UI integrations through bundled or community extensions.
• Terminal and Web Surfaces: Interact with GSD Pi via its default Text User Interface (TUI) or launch gsd --web for a visual control plane when a graphical interface is more suitable.
• Comprehensive Project Management: GSD Pi plans work, runs coding sessions with full project context and verification, utilizes Git worktrees for isolation, tracks project state in a local database, and produces valuable artifacts such as plans, summaries, and validation reports.

Installation

Getting started with GSD Pi is straightforward.

Recommended, guided installer:

npx @opengsd/gsd-pi@latest

For CI or scripted installs:

npx @opengsd/gsd-pi@latest --yes

Alternative, direct npm global install:

npm install -g @opengsd/gsd-pi@latest

If you prefer pnpm to own the global install:

pnpm setup
exec $SHELL -l
pnpm dlx @opengsd/gsd-pi@latest

For detailed migration instructions from older installs, please refer to the official documentation.

Examples

Quick Start:

Need help choosing settings? Use the GSD Pi web configurator to build a configuration in your browser.

To start a new session:

gsd

Run the setup flow, choose your preferred model provider, and open a project directory.

Common Session Commands (inside the GSD session):

/gsd config
/gsd auto
/gsd quick "Describe the task"
/gsd status

For automation, quick tasks also have a non-interactive entry point:

gsd quick --output-format json "Describe the task"

Links

• GitHub Repository: open-gsd/gsd-pi
• Discord Community: Join the GSD Discord community
• Web Configurator: GSD Pi web configurator