MIT ライセンスの Go 製ターミナル向けコーディングエージェント。的確なハッシュライン編集、分離サブエージェント、権限ゲート、低トークンな MCP に対応。DeepSeek モデルと好相性。約 12 MB で Node/Python ランタイム不要。
DSH 統合
エコシステム関連
作者による申告
安全性監査
未監査
最終検証日
2026-08-24
ライセンス
MIT
01どんなタスクに使えるのか？
ハッシュラインアンカーでファイル編集し、分離したサブエージェントを生成するターミナル向けコーディングエージェントを動かす
TUI 駆動のエージェントループ。的確な編集、~/.phi/session 配下の永続セッション、および親コンテキストへ要約だけを返すサブエージェントジョブ
OpenAI 互換または Anthropic の任意のモデルと組める、軽量で安価なローカルファーストのターミナル向けコーディングエージェントを求める開発者
CI やベンチマークでヘッドレスにコーディングタスクを実行する
TUI なしの単発エージェントループ。stdout へ JSONL イベント（--jsonl）を出力し、終了コード（0/1/2/3）を返す
機械可読な出力と厳格な権限ゲートを必要とし、パイプラインでコーディングタスクを自動化するチーム
02DeepSeek Harness への導入方法
前提条件
- OpenAI 互換または Anthropic エンドポイントのモデル API キー（PHI_API_KEY / PHI_MODEL / PHI_BASE_URL を設定、または `phi config` を実行）
- ソースからビルドする場合は Go 1.26.3 以上（go.mod 参照）
インストール手順
- 01
macOS / Linux —— 最新リリースをインストール：`curl -fsSL https://raw.githubusercontent.com/pulseaiclub/phi/main/scripts/install.sh | bash`
$ curl -fsSL https://raw.githubusercontent.com/pulseaiclub/phi/main/scripts/install.sh | bash
- 02
Windows（PowerShell 5.1+）：`irm https://raw.githubusercontent.com/pulseaiclub/phi/main/scripts/install.ps1 | iex`
- 03
またはソースからビルド：`make build`（./phi を生成）、続けて `make install`（$GOBIN へインストール）
導入成功の確認
- インストールせずに最新版を確認：`phi update --check`
- 設定済み MCP サーバーを診断：`phi mcp doctor`
03DSH 統合と能力の範囲
DeepSeek モデルと好相性のターミナル向けコーディングエージェント（PHI_MODEL / PHI_API_KEY / PHI_BASE_URL 環境変数、DeepSeek Flash を推奨）。dsh ネイティブランタイムではない
ハッシュライン編集
ファイル全体の `@file path#TAG` と行 `LINE#HASH` アンカー→的確な編集。期限切れのタグ/ハッシュは拒否され、過剰編集やサイレント破損を防ぐ
ディスク上のファイルを書き込む。権限ポリシーに従う（workspace_only_writes は既定 true）サブエージェント
agent_spawn でロール指定（explore | review | worker）→分離されたジョブ。親コンテキストへは短い wait/タスク要約だけを返す
サブエージェントのトランスクリプトは ~/.phi/jobs/<id>/ に保存され、親コンテキストには注入されない権限ゲート
モード interactive | readonly | autopilot | headless-strict；ツールごとの bash.allow / bash.deny ルール→破壊的ツール発動前に Gate / Ask。ヘッドレスの `phi run` は ask を deny に畳み込む
shell コマンドを拒否または許可可能。dangerously_allow_all は既定 falseコンテキストを食わない MCP
任意の数の MCP サーバー設定。メタツール mcp_list / mcp_inspect / mcp_call→サーバーのツール schema はモデルプロンプトに入らない——サーバー名だけ列挙。初回使用時に遅延でサブプロセス起動
MCP サブプロセスを起動。呼び出しは依然として PreHooks → Gate / Ask → Run → PostHooks を通る
04誰に向いているのか？使うべきでない場面は？
向いている用途
- OpenAI 互換または Anthropic の任意のモデルと組める、軽量で安価なローカルファーストのターミナル向けコーディングエージェントを求める開発者
- 機械可読な出力と厳格な権限ゲートを必要とし、パイプラインでコーディングタスクを自動化するチーム
不向きな用途
- phi は作業ツリーを読み書きする。`write`/`edit` は権限ポリシーに従い、workspace_only_writes は既定 true。readonly / headless-strict モードにすると書き込みを拒否できる。
05互換性・メンテナンス・セキュリティ上の注意
- ソースからのビルドには Go 1.26.3 以上が必要（go.mod 参照）。インストールスクリプトはプリビルド版を取得するため、バイナリ導入ではローカルの Go は不要。
- phi は base_url 経由でモデルプロバイダー（OpenAI 互換または Anthropic）に到達するためネットワーク接続が必要。不足時は初回に検索ツール `fd`/`rg` を ~/.phi/bin にダウンロードする。
- phi は作業ツリーを読み書きする。`write`/`edit` は権限ポリシーに従い、workspace_only_writes は既定 true。readonly / headless-strict モードにすると書き込みを拒否できる。
MIT · 活発にメンテナンス中（最新リリース v0.16.0、2026-08-22）
06よくある質問
phi をインストールして DeepSeek モデルを接続するには？
macOS/Linux は `curl -fsSL https://raw.githubusercontent.com/pulseaiclub/phi/main/scripts/install.sh | bash`、Windows は PowerShell インストールスクリプトを実行します。その後 `PHI_MODEL`/`PHI_API_KEY`（例：DeepSeek エンドポイント）を設定するか、`phi config` で ~/.phi/config.yaml を書き出します。README によると DeepSeek Flash が推奨モデルです。
phi の編集は普通のエージェントの丸ごと書き換えより何が安全？
phi はハッシュライン編集を使います。モデルはファイル全体の `@file path#TAG` アンカーと `LINE#HASH` 行アンカーを指し、ファイルを丸ごと書き換えません。期限切れのタグ/ハッシュは拒否されるため、過剰編集やサイレントなファイル破損を着地前に止められます。
サブエージェントは親コンテキストの肥大化をどう避ける？
サブエージェントツール（agent_spawn、agent_wait など）は既定で有効です。その全トランスクリプトは `~/.phi/jobs/<id>/` に保存され、親コンテキストには注入されません——親には短い wait/タスク要約だけが返ります。
phi はどうやって MCP がコンテキストウィンドウを食うのを防ぐ？
phi はシステムプロンプトに設定済み MCP サーバー名だけを列挙し、エージェントに 3 つのメタツール（mcp_list / mcp_inspect / mcp_call）を渡します。ツール schema はプロンプトに入らず、サーバーのサブプロセスは初回使用時に遅延起動されるため、実際にツールを呼ぶまで schema トークンをほぼ消費しません。
CI で無人で phi を動かせる？権限はどう振る舞う？
はい——`phi run -p "…"` は TUI なしの単発エージェントループを実行し、stdout へ JSONL を出力し終了コード 0/1/2/3 を返します。ヘッドレスモードでは ask の判断は拒否され（headless-strict 安全）、そのため readonly 相当の挙動になります。任意の shell が必要なベンチマーク/CI でのみ `--yolo` を付けてください。
07関連する DSH ワークフロー
deepseek-reasonix
by esengine
DeepSeek ネイティブのターミナル向け AI コーディングエージェント。prefix-cache 安定性を重視し、常時起動して使える
mnemon
by mnemon-dev
LLM が監督する AI エージェント向け永続メモリ。グラフベースの想起、セッション横断の知識、単一バイナリで動作し、DeepSeek Harness、Claude Code、OpenClaw などに対応
sivtr
by ariestar
人間とエージェントのための統合エージェントメモリワークスペース
caliper
by edonadei
エージェントスキルの成功率を追跡する軽量評価ハーネス。Claude Code、Codex、Pi、Hermes 対応
08データと出典
phi + DeepSeek Flash — the best pairing: grounded, low hallucination, cache hit rates near 100%.
export PHI_MODEL=gpt-4o export PHI_API_KEY=sk-...
このページは、プロジェクトの公開ドキュメント、リポジトリのメタデータ、および DSH Plugins の構造化解析に基づいて生成されています。最終検証日：2026-08-24。誤りを見つけた場合は、修正を送信してください。
dsh プラグイン おすすめ
最初に入れたい 12 のプラグイン。全カタログ・全カテゴリから厳選しました。