wangmiaozero/pi-harness

English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Русский · Français · Deutsch

Pi Coding Agent の Operational Superset

Native Pi に、視覚的なワークスペース、実行制御、復旧、エージェントチームを。

Pi Coding Agent ⊂ Pi-Harness

ダウンロード · 機能 · エージェント設定 · Harness Plugins · ドキュメント

画面プレビュー

デモ用ワークスペースで現在の画面を紹介します。画像をクリックすると拡大できます。

ワークスペース

Harness

マルチエージェント

実行前の構成例です。エージェントは待機中で、タスクは未実行です。

Pi-Harness を選ぶ理由

Pi-Harness は Pi Coding Agent を macOS、Windows、Linux のデスクトップワークスペースで利用できるようにします。会話、プロジェクト、ファイル、Git、モデル、Skills を一か所で管理し、実行の確認、予算管理、作業の復旧、エージェントチームの連携を行えます。

エージェントを実行するのは Native Pi です。Pi のセッション、設定、ツール、Skills、拡張機能との互換性を保ち、デスクトップアプリの外でも Pi を使い続けられます。

Native Pi と Pi-Harness

Pi-Harness は Pi Coding Agent の操作機能のスーパーセットです。Native Pi の機能を基盤に、観測、制御、復旧、エージェントの編成、視覚的なワークスペースを追加します。

機能	Native Pi	Pi-Harness
Agent Runtime	対応	Native Pi
Agent Loop	対応	Native Pi
Sessions	対応	対応 + 視覚的な管理
Context	対応	対応 + 確認画面
Compaction	対応	対応 + 視覚的な制御
Steering	対応	対応
Follow-up	対応	対応
Models	対応	対応 + 管理画面
Thinking	対応	対応 + 視覚的な制御
Tools	対応	対応 + 選択とポリシー
Skills	対応	対応 + 管理画面
Extensions	対応	対応 + 管理画面
Packages	対応	対応 + 管理画面
MCP / Codemode	対応	対応 + 選択とポリシー
Runs	—	対応
Trace	—	対応
Replay	—	対応
Run Compare	—	対応
Evaluation	—	対応
Policy	—	対応
Budget	—	対応
Checkpoints	—	対応
Recovery	—	対応
Diagnostics	—	対応
Regression	—	対応
Artifacts	—	対応
Multi-Agent	—	対応
Task DAG	—	対応
Handoff	—	対応
Review Gates	—	対応
Worktree isolation	—	対応
Project architecture map	—	対応

機能

ワークスペース、ファイル、Git

単独のチャットを開始したり、プロジェクトを開いて Pi セッションを再開したりできます。ストリーミング応答、思考、ツール呼び出し、画像、ファイル変更を確認し、モデル、思考レベル、ツールを選択して会話を圧縮できます。ワークスペースの「ツール」から Harness とエージェントを開いても、会話と未送信の下書きは保持されます。

ファイルの閲覧・検索、メディアとドキュメントのプレビュー、構文ハイライト、行番号、検索、元に戻す/やり直し、明示的な保存、外部変更との競合保護を備えた軽量テキスト編集に対応します。Git では差分、履歴、活動グラフ、コミット、任意の AI コミットメッセージ、worktree を利用できます。

Provider とモデル

プリセットや独自の接続先で Pi 互換 Provider を設定し、認証情報、対応サービスのモデル一覧、接続テスト、チャットモデルの選択を管理できます。対応する画像モデルでは、テキストからの画像生成や画像編集を行い、結果をダウンロードできます。

Skills、拡張機能、パッケージ、MCP

Capabilities で組み込み・ローカル Skills の閲覧と編集、Pi パッケージと拡張機能の管理を行えます。入力欄で @ を入力して、インストール済み Skill を検索・呼び出します。MCP サーバーは「設定 → MCP」で管理できます。Superpowers や Odai などを必要に応じてインストール、更新、削除できます。

デスクトップコンパニオン

設定 → デスクトップペットで BigFish を有効にすると、思考、ツール実行、入力待ち、完了の状態をデスクトップで確認できます。初期状態では無効です。メインウィンドウを最小化しても表示できます。

待機中は検索できる右クリックメニューから 193 種類のアクションを選べます。タスク実行中は手動操作を停止し、ドラッグしてもタスクのアニメーションを維持します。ローカルのペットパックを読み込み、サイズ、透明度、吹き出しをスライダーで調整できます。

エージェント設定

v2.2.10 以降で利用できます。 AI、リアルタイム音声、ショートカット、指示、MCP、サブエージェント、リモートホストの七つの設定ページを利用できます。インストーラーでの提供状況は、ダウンロードするバージョンのリリースノートを確認してください。

「設定 → AI」で既定の思考レベル、自動圧縮、エラー時の再試行、ワークスペースの設定を調整できます。「ショートカット」ではコマンドパレット、設定、新規セッション、タブを閉じる操作のキーを登録し、既定値に戻せます。「設定 → 指示」で全体またはプロジェクトの指示を編集できます。

「設定 → サブエージェント」では役割、指示、モデル、思考レベル、ツールを指定したテンプレートを作成できます。共有ワークスペースまたは独立した worktree を選び、タスクを開始したりチームで再利用したりできます。

ワークスペースのリアルタイム音声

「設定 → リアルタイム音声」で OpenAI Realtime、Gemini Live、Codex Live を設定し、入力欄の横にある波形ボタンから開始します。対応するサービスアカウントまたは個別の API キーを使用できます。Codex Live は Pi の既存の Codex ログインを使用します。利用条件と料金はアカウントによって異なります。

通話前に対象の会話を確認してください。最近の会話の共有は既定でオフです。有効にすると直近六件のプレーンテキストだけを共有し、添付ファイルとツール結果は含めません。フローティング操作部からミュート、終了、文字起こしの確認ができ、ページを移動しても操作できます。音声からの作業依頼は、確認後に対象の会話へ送信します。

MCP サーバーとマーケット

「設定 → MCP」でローカルコマンドまたは HTTP サーバーを追加できます。「すべて / グローバル / プロジェクト」で絞り込み、プロジェクトを選択し、各範囲のサーバーを編集・有効化できます。他のツールの設定をスキャンし、確認してからインポートすることもできます。

マーケットには Memory、Context7、Playwright、Filesystem、GitHub など 15 個の組み込みテンプレートがあり、公式 MCP レジストリの検索とページ送りにも対応します。保存前に設定と対象範囲を確認できます。テンプレートは必要に応じて導入するもので、すべてが有効になっているわけではありません。インポートした設定と公式レジストリの項目は無効な状態で保存され、設定を整えてから有効化します。

リモートホスト

「設定 → リモートホスト」で pi-host を実行しているホストのアドレスとペアリングトークンを入力します。接続・切断、プロジェクトとセッションの閲覧、会話の確認、プロンプト送信、承認依頼への応答ができます。接続先ではサービスが起動していて、到達可能である必要があります。

Harness：観測、制御、復旧

Runs、Trace、Replay、タイムライン、ツールの動作を確認します。実行を比較し、Run Tree で分岐や再試行を追跡して、トークン、費用、所要時間、成果物、プロジェクト統計を確認できます。

ツールのポリシーと実行ごとの予算を設定し、チェックポイントを作成して作業を再開、分岐、再試行します。評価、診断、回帰ベースラインにより、記録された実行の証拠から結果と失敗原因を確認できます。

エージェントチームとタスクの編成

再利用可能なチームとテンプレートで Pi エージェントを連携させます。タスクに依存関係、優先順位、担当を設定し、手動・順次・並列の実行、結果と成果物の引き継ぎ、レビューゲートを利用できます。worktree で変更を分離し、予算、競合の通知、一時停止、再開、中止、再試行、スキップ、再割り当てで作業を管理します。

ローカル会話履歴

Claude Code、Codex（デスクトップとアーカイブを含む）、Cursor、Cursor Agent、Gemini CLI、OpenCode、Pi の履歴をまとめて閲覧できます。検索、ソース・プロジェクト・日付範囲の絞り込み、履歴フォルダーの追加に対応します。

元の会話は読み取り専用です。引き継ぎプレビューと次の指示を確認・編集してから、同じプロジェクトの新しい Pi チャットで続行できます。閲覧、ローカルプレビュー、スキャンの再試行はモデルのトークンを消費しません。任意の AI 要約は、明示的に選択した場合だけ設定済みモデルを使います。

プロジェクト構成図

ワークスペースの Architecture でモジュール、依存関係、エントリーポイント、ソース参照を探索できます。パッケージの絞り込み、モジュールへのフォーカス、ページ切り替え、ズーム、全画面表示に対応します。分析スナップショットを保存し、ソース変更の通知を確認して、JSON、オフライン HTML、現在の表示の PNG を出力できます。

ローカル分析はモデルのトークンを消費せず、AI の説明は任意です。JavaScript、TypeScript、Vue のインポート関係をローカルで解析し、その他の対応言語にはファイル単位の索引を提供します。分析の対象範囲と制限も表示します。

テーマとカスタムスキン

クラシック配色、Ming、Starship Cockpit、macOS 27 の背景、読み込んだカスタムスキンを選べます。新規インストールはダークで開始します。チャットの表示名、アプリアイコン、ローカル背景画像、ウィンドウと画面のグロー、入力欄の炎エフェクトを変更できます。起動時の環境確認にはアニメーションが付き、マスコットなし版でも一般の外観設定を使えます。

環境とアプリ設定

Node.js、npm、PATH、Pi Coding Agent、現在の設定を確認します。対応環境では Pi のインストール、更新、修復を行い、環境診断、設定のバックアップ、アプリ更新の確認も利用できます。インターフェースは八言語に対応しています。

カスタムスキンを作成

Pi-Harness カスタムスキン・スターターで好みのスタイルを作成できます。

1. スターターをテンプレートとして使うか、ダウンロードします。
2. コーディングエージェントで開き、付属のプロンプトで希望するスタイルを説明します。
3. 完成したプロジェクトを「設定 → テーマ → スキンを読み込む」から読み込みます。

多言語スターターには配色、プレビュー、壁紙、任意のキャラクター画像の説明があります。スキンを独立したリポジトリで更新・共有できます。

スクリーンショット

機能画面はテーマ別に分類しています。その他の画面はスクリーンショット一覧をご覧ください。

デスクトップコンパニオン

会話履歴

セッションの整理

クラシックテーマ

軽量ファイル編集

エージェント設定 · ワークスペース音声 · MCP

ワークスペース音声

通話前の設定と準備画面：

MCP マーケット

設定ページ	スクリーンショット
AI 設定	表示
リアルタイム音声	表示
ショートカット	表示
全体とプロジェクトの指示	表示
MCP サーバー	表示
サブエージェント	表示
リモートホストのペアリング	表示

Git · Provider とモデル · Capabilities · Harness · プロジェクト構成図

Git

Provider とモデル

Capabilities

Harness

プロジェクト構成図

Ming の機能画面

一般設定 · テーマとスキン

一般設定

テーマとスキン

テーマギャラリー

Ming · 雪景の官人 · Ming · 雪夜の笛奏者 · Ming · 月城の書姫 · Starship Cockpit · macOS 27 · Liquid Ether

Ming · 雪景の官人

Ming · 雪夜の笛奏者

Ming · 月城の書姫

Starship Cockpit

macOS 27 · Liquid Ether

Harness Plugins — コントロールプレーンを拡張

Plugin SDK v1.0.0 · Pi-Harness v2.2.6 以降で利用できます。イベント購読、カスタム評価、JSON トレース出力、チームテンプレートを提供します。実行コードには明示的な信頼が必要です。別プロセスは安全なサンドボックスではありません。

開発とインストール · Architecture · SDK API · Security · Examples

ダウンロード

GitHub Releases から公開済みのインストーラーをダウンロードし、使用するプラットフォームのファイルを選んでください。

プラットフォーム	インストーラー
macOS Apple Silicon	.dmg · arm64
macOS Intel	.dmg · x64
Windows x64	.exe · Windows インストーラー
Linux x64	.AppImage

パッケージ版ではリポジトリの clone や pnpm のインストールは不要です。対応環境では Pi と実行環境のセットアップをアプリから行えます。

macOS のコミュニティビルドは署名されていない場合があります。初回起動がブロックされた場合は「システム設定 → プライバシーとセキュリティ → このまま開く」を使用してください。

使い始める

1. Pi-Harness を起動し、概要で環境を確認します。
2. Provider を設定して接続をテストし、モデルを選択します。
3. 単独のチャットを開始するか、プロジェクトを開きます。
4. Pi セッションを開始・再開し、会話、ファイル、Git を操作します。
5. 実行制御やチーム連携にはワークスペースの「ツール」を開きます。

音声会話を始める

リアルタイム音声を始めるには：

1. 「設定 → リアルタイム音声」で音声を有効にし、サービスとアカウントを選んで保存します。
2. ワークスペースの会話に戻り、入力欄の横の波形ボタンを押します。
3. 対象の会話と任意の共有設定を確認し、「リアルタイム音声を開始」を選んでマイクへのアクセスを許可します。
4. 通話操作部でミュート、詳細表示、終了を行います。作業依頼は確認してからコーディングエージェントへ送信します。

必要環境

macOS Apple Silicon、macOS Intel、Windows x64、Linux x64 に対応します。対応環境ではアプリから Pi Coding Agent をインストール・修復できます。ソースからの実行には Node.js 24 LTS (≥ 24.22.1) と pnpm 9.12.1 が必要です。

ドキュメント

• エージェント設定
• スクリーンショット一覧
• 変更履歴

謝辞と作者

公式の Pi Coding Agent と Pi Agent Harness を中心に構築しています。

作成・保守：wangmiao · [email protected]。

PR コントリビューター

HenryArch PR #8

Pi-Harness をより良くする PR を歓迎します。プロジェクトの改善に協力してくださるすべての方に感謝します！

ライセンス

Pi-Harness は GNU Affero General Public License v3.0 only（AGPL-3.0-only）で公開されています。

Copyright © 2026 wangmiao.