{"name":"GSD Pi: Autonomous Coding Agent for Spec-Driven Development","description":"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","url":"https://osrepos.com/repo/open-gsd-gsd-pi","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/open-gsd-gsd-pi","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/open-gsd-gsd-pi.md","json":"https://osrepos.com/repo/open-gsd-gsd-pi.json","topics":["context-engineering","meta-prompting","spec-driven-development","TypeScript","AI agent","developer tools","workflow automation","CLI"],"keywords":["context-engineering","meta-prompting","spec-driven-development","TypeScript","AI agent","developer tools","workflow automation","CLI"],"stars":null,"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.","content":"## Introduction\n\nGSD 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.\n\n## Why Use and Key Benefits\n\nGSD Pi offers a robust set of features to enhance developer productivity and project autonomy:\n\n*   **Guided Terminal Agent:** Start with `gsd` to configure providers and run planned or quick coding sessions directly from your shell.\n*   **Autonomous Project Workflow:** Break down work into milestones, slices, and tasks, then utilize auto mode to plan, implement, verify, and advance the project automatically.\n*   **Worktree-Aware Git Automation:** Maintain isolated implementation work while preserving a clean, reviewable main checkout, ensuring project integrity.\n*   **Local Project Memory:** Store all critical project requirements, decisions, runtime notes, generated plans, summaries, and validation evidence securely under `.gsd/`.\n*   **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.\n*   **Extension Surface:** Extend GSD Pi's capabilities by adding project-specific commands, tools, skills, and UI integrations through bundled or community extensions.\n*   **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.\n*   **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.\n\n## Installation\n\nGetting started with GSD Pi is straightforward.\n\n**Recommended, guided installer:**\n\nbash\nnpx @opengsd/gsd-pi@latest\n\n\n**For CI or scripted installs:**\n\nbash\nnpx @opengsd/gsd-pi@latest --yes\n\n\n**Alternative, direct npm global install:**\n\nbash\nnpm install -g @opengsd/gsd-pi@latest\n\n\n**If you prefer pnpm to own the global install:**\n\nbash\npnpm setup\nexec $SHELL -l\npnpm dlx @opengsd/gsd-pi@latest\n\n\nFor detailed migration instructions from older installs, please refer to the official documentation.\n\n## Examples\n\n**Quick Start:**\n\nNeed help choosing settings? Use the [GSD Pi web configurator](https://pi.opengsd.net/) to build a configuration in your browser.\n\nTo start a new session:\n\nbash\ngsd\n\n\nRun the setup flow, choose your preferred model provider, and open a project directory.\n\n**Common Session Commands (inside the GSD session):**\n\ntext\n/gsd config\n/gsd auto\n/gsd quick \"Describe the task\"\n/gsd status\n\n\n**For automation, quick tasks also have a non-interactive entry point:**\n\nbash\ngsd quick --output-format json \"Describe the task\"\n\n\n## Links\n\n*   **GitHub Repository:** [open-gsd/gsd-pi](https://github.com/open-gsd/gsd-pi)\n*   **Discord Community:** Join the [GSD Discord community](https://discord.gg/vY2bv3FrzX)\n*   **Web Configurator:** [GSD Pi web configurator](https://pi.opengsd.net/)","metrics":{"detailViews":1,"githubClicks":1},"dates":{"published":null,"modified":"2026-09-10T23:46:09.000Z"}}