# GSD Pi: Autonomous Coding Agent for Spec-Driven Development

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/open-gsd-gsd-pi
Generated for open source discovery and AI-assisted research.

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.

GitHub: https://github.com/open-gsd/gsd-pi
OSRepos URL: https://osrepos.com/repo/open-gsd-gsd-pi

## Summary

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.

## Topics

- context-engineering
- meta-prompting
- spec-driven-development
- TypeScript
- AI agent
- developer tools
- workflow automation
- CLI

## Repository Information

Last analyzed by OSRepos: Fri Sep 11 2026 00:46:09 GMT+0100 (Western European Summer Time)
Detail views: 1
GitHub clicks: 1

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## 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:**

bash
npx @opengsd/gsd-pi@latest


**For CI or scripted installs:**

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


**Alternative, direct npm global install:**

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


**If you prefer pnpm to own the global install:**

bash
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](https://pi.opengsd.net/) to build a configuration in your browser.

To start a new session:

bash
gsd


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

**Common Session Commands (inside the GSD session):**

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


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

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


## Links

*   **GitHub Repository:** [open-gsd/gsd-pi](https://github.com/open-gsd/gsd-pi)
*   **Discord Community:** Join the [GSD Discord community](https://discord.gg/vY2bv3FrzX)
*   **Web Configurator:** [GSD Pi web configurator](https://pi.opengsd.net/)