「pi」は、既存のコーディングエージェント(Claude Code等)が抱える「機能の固定化」や「システムプロンプトの肥大化によるトークン消費」という課題に対し、真逆のアプローチを取るオープンソースのコーディングエージェントである。
自身をエージェントの骨組みである「ハーネス(Harness)」と定義し、最小限のコア機能(ツール定義込みでシステムプロンプト1000トークン未満)のみを提供。MCP(Model Context Protocol)やサブエージェント、プランモードといった機能は標準搭載せず、必要に応じてユーザー自身がTypeScript等で拡張・追加していく設計思想を持つ。
マルチプロバイダ対応、柔軟なセッション管理、4つの動作モードを備え、高いカスタマイズ性と実用性を両立させている。
事象の背景と構造
現在、多くのコーディングエージェントは「全部入り(All-in-one)」の設計を採用している。しかし、実務での利用においては以下の構造的な課題が生じている。
既存エージェントの構造的課題
- システムプロンプトの肥大化: 初期状態で多様な機能やツール定義をプロンプトに含めるため、1リクエストあたりの消費トークン数(コンテキストコスト)が増大する。
- 機能の固定化: ユーザー固有のワークフローやプロジェクト特有のルールに合わせた柔軟なカスタマイズが困難であり、公式のアップデートを待つ必要がある。
piのポジショニングと実績
piは「ハーネスを変えろ、ワークフローを変えるな」を掲げ、ユーザー自身がエージェントを構築・拡張するための土台を提供する。
- 成長性: リリースから半年でGitHubスター数54Kを獲得。
- 性能: 開発者向けベンチマーク「Terminal-Bench 2.0」において49.8%のスコアを記録(61エントリ中7位)。軽量なコアでありながら、高いタスク遂行能力を持つ。
![[pi]極小のコアと無限の拡張性を持つコーディングエージェント](https://mtoy.work/develop/wp-content/themes/cocoon-master/images/no-image-160.png)
コアとなる技術的仕組みの解説
1. 最小限のコアとシステムプロンプトの最適化
piは、標準状態ではMCPやサブエージェント、プランモードを持たない。ツール定義を含めたシステムプロンプトを1000トークン未満に抑えることで、LLMのコンテキストウィンドウを節約し、推論の高速化とAPIコストの削減を実現している。
2. マルチプロバイダと柔軟なセッション管理
- 対応プロバイダ: Anthropic、OpenAI、Gemini、DeepSeekなど20以上のLLMプロバイダに対応。
- 認証の柔軟性: 開発者向けのAPIキーだけでなく、既存のWebサブスクリプション(Claude Pro、ChatGPT Plus等)の認証を利用した中継に対応。
- 文脈を維持したモデル切り替え: セッション(会話)の途中で、コンテキストを保持したままプロバイダやモデルを動的に切り替えることが可能。
- ツリー構造のセッション管理: 会話履歴を一本道のスレッドではなく「ツリー構造」で保持する。過去の任意のノード(分岐点)に戻って別の指示を試行できる(`tree`コマンドで制御)。
- コンテキスト圧縮: セッションが長大化した際、古いメッセージ履歴を自動的に要約・圧縮してコンテキスト上限の圧迫を防ぐ。元の詳細な履歴はローカルファイルに保存される。
3. 4つの動作モード
用途やシステム連携の要件に応じて、以下の4つのモードを選択できる。
| モード | 概要・ユースケース |
|---|---|
| interactive | ターミナル上で対話的にコーディングを進めるチャット形式のモード。 |
| 標準入出力を介してパイプライン処理に組み込むモード(例: `cat file \pi “summary”`)。 | |
| RPC | JSONを介して外部プロセスからpiを制御するモード。Node.js以外の言語(Python, Go等)からの呼び出しに対応。 |
| SDK | 自作アプリケーションにpiのエージェント機能を直接埋め込むためのライブラリモード。 |
4. 拡張機能(Extension)のプリミティブ
piは以下の4つの要素を組み合わせてカスタマイズを行う。作成した拡張機能は「Pi Package」としてnpmやGitHub経由で配布・管理できる。
- Extension: TypeScriptを用いて、独自のツール、コマンド、UI、キーバインドなどを定義する。
- Skill: オンデマンドで読み込まれる能力。常時ロードしないため、トークン消費を抑制できる。
- Prompt Template: 頻出するプロンプトパターンの再利用テンプレート。
- Theme: ターミナル上の外観カスタマイズ。
![[pi]極小のコアと無限の拡張性を持つコーディングエージェント](https://mtoy.work/develop/wp-content/uploads/sites/3/2026/10/Strix-logo-320x180.png){kind=logo}
今後の影響と論点
1. セキュリティモデルと実行環境の分離
piはデフォルトでローカルのファイルシステムに対するフルアクセス権限を持つ。Claude Codeのように実行前にユーザーへ権限確認のポップアップを挟まない設計となっているため、以下の対策が前提となる。
- 隔離環境での実行: 公式はDockerコンテナなどのサンドボックス環境内での実行を強く推奨している。
- サプライチェーンリスク: サードパーティ製の拡張機能(Pi Package)は任意のコードを実行できるため、導入時のソースコード検証が不可欠である。
2. 「エージェントをセルフホスト・セルフビルドする」開発文化
従来の「提供されたエージェントの仕様に人間が合わせる」形から、「エージェントの挙動(システムプロンプト、ツール定義、割り込み処理)をエンジニア自身がコードで制御する」形へのシフトを促す。
作業中にEnterキーで処理に割り込む「steering」や、Alt+Enterでタスク終了後の指示を予約する「follow-up」など、開発者のタッチポイントに配慮した制御ロジックも、この思想を支える重要な要素となっている。
コメント