pi アーキテクチャ解剖ソースをトップダウンで読む

日本語の学習サイト。badlogic/pi-mono の全体設計をレイヤーごとに分解していく。各ステップは GitHub の該当ソース行に直接リンクし、バージョンは v0.73.1 に固定。

トップダウン

pi-ai の統一 LLM API → pi-agent-core のループ → pi-coding-agent CLI → pi-tui ターミナル UI → pi-web-ui ウェブコンポーネント、の順に一屚ずつ下へ降りていく。

各重要ファイルには SrcLink が付き、クリックすると GitHub 上の該当行が開く。バージョンは v0.73.1 に固定しているので、バージョンアップは一箇所の書き換えで済む。

単なるポインタではない。重要関数の 5〜15 行の実際の TypeScript ソースをそのままページに貼り、前後に日本語で何をしているかを記す。

各ページは役割だけでなく、なぜこの設計になったのか、境界ケースや失敗モードをどう扱うかまで書く。

pi-mono は monorepo: pi-ai(基盤)→ pi-agent-core(汎用 agent)→ pi-coding-agent(コーディング CLI)+ pi-tui(ターミナル)+ pi-web-ui(ウェブ)。パッケージ同士がどう組み合わさるかを示す。

本サイトはアーキテクチャ解剖とソース位置の標識に集中する。インストールや使い方は公式 README を参照し、重複して使い方ドキュメントは作らない。