gsd-pi

GSD Pi — open-gsd コミュニティのローカルファーストコーディングエージェント（CLI・TUI・Web）

1 — 概要

プロジェクト

@opengsd/gsd-pi 1.1.x MIT Node 22+

GSD Pi（GitHub: open-gsd/gsd-pi）は、計画・実装・検証・進捗追跡をターミナルから行うローカルファーストのコーディングエージェント。Pi 系エージェント基盤の上に、マイルストーン／スライス／タスクのワークフロー、worktree 分離、.gsd/ へのプロジェクト記憶、拡張面を載せている。

README では「アイデアからレビュー可能な実装まで、手動調整を減らす」ことを目的に掲げ、TUI をデフォルトとしつつ gsd --web で Web コントロールプレーンも使える。

gsdCLI バイナリ

.gsd設定・状態ディレクトリ

Unit最小実行ステップ

pnpmモノレポ

コミュニティ継続: VISION.md によると、本リポジトリは元 GSD プロジェクトの open-gsd 組織によるコミュニティ主導の継続開発ライン。v1 系は gsd-core として別途メンテされる。

2 — 主な機能

ガイド付きターミナルエージェント

gsd で起動し、プロバイダー設定のあと計画セッションやクイックタスクを実行。

自律プロジェクトワークフロー

マイルストーン・スライス・タスクへ分解し、auto モードで計画→実装→検証→前進を繰り返す。

worktree 対応 Git

実装を worktree に隔離し、メイン checkout はレビュー可能な状態を保つ。

ローカルプロジェクト記憶

要件・決定・ランタイムメモ・計画・検証証跡を .gsd/ に保存。DB と Markdown 投影の両方。

マルチプロバイダー

フェーズごとのモデル設定。Anthropic / OpenAI / Google など複数経路をルーティング。

拡張面

バンドル拡張・スキル・MCP・ブラウザ自動化・リモート質問などを src/resources/extensions/ から提供。

TUI / Web

対話は TUI が既定。gsd --web でブラウザ UI と API 面を起動。

Cloud MCP Gateway

ローカル runtime とクラウド MCP エンドポイントをペアリングし、外部 MCP クライアントから GSD ツール面を公開。

3 — インストールとクイックスタート

推奨インストール

npx @opengsd/gsd-pi@latest

CI やスクリプト向けには --yes を付ける。グローバル npm なら npm install -g @opengsd/gsd-pi@latest。旧 unscoped gsd-pi から移行する場合は README のマイグレーション手順（アンインストール → 状態ファイル削除 → 再インストール）に従う。

1シェルで gsd を実行しセットアップフローを完了する。
2モデルプロバイダーを選び、作業ディレクトリを開く。
3計画・実行状態はプロジェクト直下の .gsd/ に蓄積される。

ブラウザで設定を組み立てる場合は GSD Pi web configurator を参照。

4 — ワークフローとコマンド

階層

flowchart TB
  M[Milestone] --> S[Slice]
  S --> T[Task]
  T --> U[Unit]
  U --> A[Auto Orchestration]
  A --> W[Worktree 実装]
  A --> V[検証・closeout]

CONTEXT.md の用語では Unit が最小実行ステップ（plan slice / execute task / complete slice など）。Auto Orchestration が dispatch 前の不変条件パイプラインとライフサイクル遙測を担い、State Reconciliation → Dispatch → Tool Contract → Worktree Safety の順で pre-dispatch を通す設計（ADR-014 / ADR-015）。

操作	コマンド例	用途
セッション開始	`gsd`	対話セッションを開く
設定	`/gsd config`	プロジェクト設定
自動実行	`/gsd auto`	auto モードで Unit を進める
クイックタスク	`/gsd quick "…"`	単発タスク
状態確認	`/gsd status`	進捗・ランタイム状態
使用量	`/gsd usage`	セッション使用量（新リリース）
コンテキスト	`/gsd context`	コンテキスト状態の確認
Web UI	`gsd --web`	ブラウザコントロールプレーン
アップグレード	`gsd upgrade`	ルーティン更新

5 — アーキテクチャ

ランタイムモジュール

CONTEXT.md が採用する深いモジュール:

Auto Orchestration — start / advance / resume / stop / getStatus。pre-dispatch パイプラインのオーケストレーション。
State Reconciliation — DB・ディスク・メモリ間の drift 検出と修復（ADR-017）。
Worktree Safety / Lifecycle / State Projection — ソース書き込み Unit の worktree 根保証と状態ファイルの方向性ルール。
Recovery Classification — プロバイダー・ツール・Git 失敗を retry / escalate / abort に分類。
Tool Contract — Unit プロンプト・ツールスキーマ・ポリシーの整合。

パッケージ / 領域	役割
`@gsd/pi-coding-agent`	Pi 系コーディングエージェント CLI コア（read / write / edit / bash）
`@gsd/pi-ai`	統一 LLM プロバイダー API
`@gsd/pi-agent-core`	エージェントループ・ハーネス・compaction
`@gsd/pi-tui`	ターミナル UI
`@gsd/agent-core` / `@gsd/agent-modes`	GSD エージェントセッションと interactive / RPC モード
`@opengsd/mcp-server`	プロジェクト MCP サーバー
`@opengsd/daemon`	Local GSD Runtime（Cloud MCP Gateway 接続）
`@opengsd/cloud-mcp-gateway`	クラウド MCP ゲートウェイ runtime
`@gsd/native` / `native/`	ネイティブエンジン・プラットフォームバイナリ
`web/`	Web UI と API
`src/resources/extensions/gsd/`	GSD ワークフロー拡張（DB・orchestrator・commands 等）

設計原則（VISION.md）: Extension-first・Simplicity over abstraction・Tests are the contract・Provider-agnostic。コアは薄く保ち、拡張可能な能力は extensions / skills 側へ寄せる。

6 — リポジトリ構成

パス	内容
`src/`	コア runtime リソースとバンドル拡張
`packages/`	CLI・エージェント・TUI・RPC・MCP・daemon 等の workspace パッケージ
`native/`	ネイティブエンジンのパッケージング
`web/`	Web UI / API
`docs/`	ユーザー向け・開発者向けドキュメント
`gsd-orchestrator/`	オーケストレーター skill と workflow テンプレート
`scripts/`	ビルド・リリース・検証スクリプト

7 — 開発

pnpm install --frozen-lockfile
pnpm run build
pnpm test

# PR 前
pnpm run verify:fast
pnpm run verify:pr
pnpm run verify:merge

Node.js 22 以上、package manager は pnpm 10.x。公開ベースラインは 1.0.0 からの新系譜で、CHANGELOG はこの baseline 以降を正とする。

8 — リンク

open-gsd/gsd-pi — ソースリポジトリ
@opengsd/gsd-pi — npm パッケージ
Web configurator — ブラウザ設定 UI
Discord — コミュニティ
The Promise — プロジェクト背景

← 資料一覧に戻る