BlackBeltTechnology/pi-agent-dashboard

PI Dashboard – クイック概要

概要: 複数の pi コーディングエージェントインスタンス（Bad LogicによるオープンソースのAI駆動コードアシスタント pi）を実行、監視、操作するためのWebベースのコントロールパネルです。このダッシュボードはNode.jsサーバー（またはElectronデスクトップアプリ）として動作し、単一のブラウザタブで新しいエージェントの起動、リアルタイムの推論の確認、OpenSpecの変更の適用、コスト管理を行うことができます。

主な機能

• リアルタイムセッションミラーリング – アクティブなすべてのpiセッションがUIに即座に表示され、ライブストリーミングチャット、トークン使用量、モデル情報、進捗ゲージを確認できます。
• 双方向インタラクション – ブラウザから直接プロンプトの送信、ツールコマンドの実行、ask_user ダイアログへの応答が可能です。
• ワークスペースの整理 – セッションはフォルダ/ブランチごとにグループ化され、ドラッグ＆ドロップで並べ替えが可能です。
• 統合ターミナルと差分ビューア – ブラウザ内蔵ターミナル (xterm.js + node-pty) と、ファイル変更用のサイドバイサイド差分ツールを備えています。
• OpenSpec & flow統合 – 同じUIから仕様変更の閲覧、pi-flowの実行、フローグラフの表示が可能です。
• プロバイダー管理 – Anthropic、OpenAI、GeminiなどのAPIキーを追加可能。カスタムLLMエンドポイントもサポートされており、即座に反映されます。
• 拡張システム – プラグインにより、Reactコードを書かずにスラッシュコマンドでトリガーされるモーダルUIを公開できます。
• ネットワーク – 自動mDNS検出、オプションのZrokパブリックトンネル、Claude Desktopなどの外部クライアント用のMCPエンドポイント (POST /mcp) を提供します。
• モバイル対応 – タッチターゲットとスワイプドロワーを備えたレスポンシブレイアウトです。

導入方法

1. Electronアプリ – GitHub Releasesページからビルド済みのインストーラー（macOS, Linux, Windows）をダウンロードします。Node.jsやターミナルは不要で、ウィザードが ~/.pi-dashboard/ にpiとダッシュボードをセットアップします。
2. npmパッケージ – npm i -g @blackbelt-technology/pi-agent-dashboard を実行し、pi-dashboard を起動します（または pi install npm:@blackbelt-technology/pi-agent-dashboard）。http://localhost:8000 で開きます。
3. ソースからビルド – リポジトリをクローンし、corepack enable でpnpmを有効化し、pnpm install && pnpm run build を実行後、pi install … でインストールします。
4. Docker – docker フォルダ内で docker compose up -d --build を実行すると、スタック全体（サーバー、piエージェント、code-server、Zrok、tmux）がコンテナ内で実行されます。

典型的なワークフロー

• ダッシュボード（デスクトップアプリまたはブラウザ）を起動します。
• Settings ペインを使用してLLMプロバイダーのキーを追加します。
• New Session をクリックし、フォルダ/ブランチと起動戦略（ヘッドレスまたはtmux）を選択します。
• エージェントの推論ストリームをリアルタイムで監視し、ask_user プロンプトに応答します。
• サイドバーからOpenSpecの変更を適用したり、pi-flowを実行したりします。
• 終了したら、セッションを停止（ソフトアボート → 強制終了）するか、完了させてログをエクスポートします。

対象ユーザー

• すでに pi コーディングエージェントを使用しており、複数のエージェントを視覚的に管理したい開発者。
• トークン消費量の監視、プロジェクトごとのセッション整理、またはZrokを介したリモート共同作業者へのダッシュボード公開が必要なチーム。
• カスタムモーダルダイアログでUIを拡張したいプラグイン作成者。

詳細情報

• デモサイト: https://blackbelttechnology.github.io/pi-agent-dashboard
• Discordコミュニティ: https://discord.gg/uQsJgsejb
• インストール、設定、拡張機能作成、トラブルシューティングを網羅した完全なドキュメントはリポジトリの (docs/ フォルダ) にあります。

---

結論: PI Dashboardは、複数の pi AIコーディングエージェントをオーケストレーションするための実用的なプロダクションレディなUIであり、リアルタイム監視、セッション制御、拡張性を提供します。これらすべてが単一のブラウザタブまたはパッケージ化されたElectronアプリからアクセス可能です。