# 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

Repository: https://github.com/open-gsd/gsd-pi
Canonical: https://ross.abutalabs.com/products/gsd-pi
Homepage: https://www.opengsd.net
Language: TypeScript
License: MIT
License Family: permissive
Topics: context-engineering, meta-prompting, spec-driven-development
Last push: 2026-09-02T02:27:45+00:00

## Health v2 (maintenance only)
Score: 81/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 100, release rhythm 99, longevity 7
- inputs: {"age_days": 103, "days_push": 1, "days_rel": 4, "gap_med": 2.5, "n_releases_24m": 21}
- flags: young
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1193, forks 103 (observed 2026-09-03T02:15:15.695667+00:00)

## What it is
GSD Pi is a local-first, terminal-based autonomous coding agent that plans, implements, verifies, and tracks project work using spec-driven development and context engineering. It breaks work into milestones, slices, and tasks, uses worktree-isolated Git automation, and routes across multiple LLM providers.

## Use cases
- run an autonomous coding agent from the terminal
- break a project into milestones and tasks for AI implementation
- keep AI coding agents from losing context on long tasks
- isolate agent work in git worktrees while keeping main reviewable
- route coding agent across multiple LLM providers
- spec-driven development workflow for AI agents

## When to choose
- you want a standalone terminal coding agent with planning and verification built in
- you need long-running autonomous agent sessions that stay aligned with project specs
- you want worktree-isolated git automation and local project memory
- you want to use existing API keys, OAuth, or external CLI providers like Claude Code

## When to avoid
- you only want a prompt library to layer onto an existing runtime like Cursor or Claude Code (use GSD Core instead)
- you need a fully managed cloud agent service
- you prefer a GUI-only workflow without terminal interaction

## Facets
- artifact type: cli-tool
- maturity: active
- function: agent-framework, developer-tools, cli, workflow-automation, prompt-engineering
- domain: developer-tools, large-language-models
- platform: cli, cross-platform, windows
- tags: coding-agent, spec-driven-development, context-engineering, meta-prompting, terminal-ui, git-worktrees, multi-provider-llm, autonomous-agents, automation, ai-agents, nodejs, macos, linux

## Member repositories
- open-gsd/gsd-pi (main) score 81

## Provenance
- Observed fields: from GitHub, fetched 2026-09-03T02:15:15.695667+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:31:54.920610+00:00, confidence not recorded.
  - readme: https://github.com/open-gsd/gsd-pi (fetched 2026-09-03T02:15:15.695667+00:00, sha 09271aea681a)
  - homepage: https://www.opengsd.net (fetched 2026-08-29T12:36:56.547722+00:00, sha 6a3d62c2e153)
  - site_page: https://www.opengsd.net/about (fetched 2026-08-29T12:36:56.556940+00:00, sha 144a7a1e7c7d)
  - site_page: https://docs.opengsd.net/ (fetched 2026-08-29T12:36:56.558681+00:00, sha 8f105de4f56a)
  - site_page: https://www.opengsd.net/docs (fetched 2026-08-29T12:36:56.560289+00:00, sha 485bf4dcd655)
- Data as of 2026-08-30T08:39:29.467469+00:00.