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

GSD Pi란?

GSD Pi(Git‑aware Software Development Pi의 약자)는 터미널(또는 선택적 웹 UI)에서 작동하는 로컬 우선 AI 코딩 어시스턴트입니다. 소프트웨어 아이디어를 전체 개발 주기로 진행하는 데 도움을 줍니다:

계획 – 프로젝트를 마일스톤, 슬라이스, 작업으로 분해합니다.
구현 – 대규모 언어 모델(LLM)로 코드를 생성하면서 전체 프로젝트 컨텍스트를 유지합니다.
검증 – 자동 검사를 실행하고 검증 증거를 수집합니다.
추적 – 모든 계획, 메모, 요약, 검증 결과를 숨겨진 .gsd/ 폴더에 저장합니다.
Git 워크트리 자동화 – 생성된 작업을 별도의 Git 워크트리에 격리하여 메인 브랜치를 깨끗하고 검토 준비된 상태로 유지합니다.

이 도구는 명령줄에서 호출할 수 있는 AI 기반 "에이전트"를 원하는 개발자를 위해 설계되었으며, 모든 것을 오프라인 친화적(모든 상태가 사용자 머신에 저장)이고 커뮤니티 확장을 통해 확장 가능하게 유지합니다.

핵심 기능(README 설명)

기능	설명
가이드 터미널 에이전트	`gsd`를 실행하여 대화형 세션을 시작하고, LLM 공급자를 구성하고, 코딩 또는 빠른 작업 모드를 셸에서 직접 시작합니다.
자율 프로젝트 워크플로우	마일스톤/슬라이스/작업을 정의합니다. auto 모드는 추가 프롬프트 없이 계획, 코딩, 검증, 작업 진행을 수행할 수 있습니다.
워크트리 인식 Git 자동화	Git 워크트리를 사용하여 생성된 코드를 격리하고 깨끗하고 검토 가능한 메인 체크아웃을 유지합니다.
로컬 프로젝트 메모리	프로젝트별 데이터(요구 사항, 결정, 계획, 검증 노트)는 모두 `.gsd/`에 저장되며 기본적으로 git 무시됩니다.
멀티 공급자 모델 라우팅	이미 보유한 모든 모델에서 작동합니다 – API 키, OAuth 또는 Claude Code나 Cursor Agent와 같은 CLI 기반 공급자.
확장 표면	프로젝트는 번들 또는 커뮤니티 확장을 통해 사용자 지정 명령, 도구, UI 통합을 추가할 수 있습니다.
터미널 및 웹 표면	기본 TUI; 시각적 제어 평면용 웹 UI를 `gsd --web`으로 시작합니다.

빠른 시작 흐름(README에서)

설치 – 권장 원라이너:
```
npx @opengsd/gsd-pi@latest
```
(또는 전역 설치에는 npm install -g @opengsd/gsd-pi)
에이전트 실행:
```
gsd
```
안내 설정을 따라 모델 공급자를 선택합니다(예: Cursor Agent, Claude 등).
세션 시작 – 대화형 UI에서 슬래시 명령을 실행할 수 있습니다:
- /gsd config – 설정 변경
- /gsd auto – 에이전트가 전체 자율 워크플로우를 실행하게 함
- /gsd quick "작업 설명" – 일회성 코딩 요청
- /gsd status – 현재 진행 상황 보기
비대화형 사용 – 스크립트용으로 호출할 수 있습니다:
```
gsd quick --output-format json "작업 설명"
```
구조화된 JSON 결과와 의미 있는 종료 코드를 반환합니다.

GSD Pi를 누가 사용할까요?

개인 개발자 – 작업을 체계적으로 유지하고 반복적인 코딩/검증 단계를 자동화하는 AI 파트너를 원하는 사람.
소규모 팀 – 클라우드 전용 서비스보다 로컬 자체 호스팅 어시스턴트를 선호하는 팀.
오픈소스 관리자 – AI 기반 계획 및 코드 생성을 저장소 워크플로우에 통합하려는 사람.
도구 빌더 – 제공된 확장 표면을 통해 사용자 지정 명령이나 UI 통합으로 GSD Pi를 확장할 수 있는 사람.

설치 및 업그레이드 세부 정보

안내 설치 프로그램(npx @opengsd/gsd-pi@latest)이 구성을 안내하고 gsd 바이너리를 생성합니다.
업그레이드는 단일 명령: gsd upgrade(또는 npx를 통한 재설치).
이전 스코프 없는 gsd-pi 패키지에서 이동하는 사용자를 위한 마이그레이션 지침이 제공됩니다.
제거는 전역 패키지와 ~/.gsd 상태 디렉터리를 제거합니다.

개발 및 커뮤니티

저장소는 pnpm 모노레포 레이아웃(src/, packages/, native/, web/)을 사용합니다.
빌드/테스트 명령: pnpm install --frozen-lockfile, pnpm run build, pnpm test.
기여 워크플로우에는 빠른 로컬 검증 스크립트(pnpm run verify:*)가 포함됩니다.
커뮤니티 지원은 Discord 서버에서 제공됩니다(README에 링크).

라이선스

MIT – 개인, 학술, 상업적 사용에 무료.

결론: GSD Pi는 사용자 머신에서 실행되고 Git과 긴밀하게 통합되며 엔드투엔드 프로젝트 개발을 위한 터미널 및 웹 인터페이스를 모두 제공하는 진정하고 활발히 유지 관리되는 AI 기반 코딩 에이전트입니다.