vastsa/PI-Desktop

PI‑Desktop – AIコーディングエージェント向けローカル優先デスクトップ

何であるか – PI‑Desktopは、macOS、Windows、Linuxに対応するクロスプラットフォームデスクトップアプリです。大規模言語モデルに基づくコーディングエージェントに専用のワークスペースを提供します。チャットウィンドウでもエディタプラグインでもありません。プロジェクト、セッション、ファイル編集、コマンド実行、長時間実行のエージェント作業を管理するフル機能UIであり、すべてのデータはユーザーのマシン上に保持されます。

主なコンセプト

コンセプト	得られるもの
独自モデルの接続	OpenAI、Anthropic、Ollama、LM Studio、または任意のOpenAI互換エンドポイントに接続できます。モデルごとに設定（コンテキストウィンドウ、温度、推論レベルなど）をカスタマイズし、リアルタイムでモデルを切り替えられます。
プロジェクト中心	任意のローカルリポジトリを開けます。すべてのセッション、差分、レビュー、生成されたファイルはコードと並んで保存されます。Claude Code、Codex、OpenCode、またはPiからセッションをインポートできます。
制御レイヤー	エージェントはファイルの読み書きやコマンド実行が可能ですが、権限の高い操作は、差分やコマンド出力、完全な自律性の承認を求めるUIで制限されます。
3つのワークフロー・モード	エージェント – 自由な編集、高速処理；プラン – エージェントが変更不可の実装計画を提示し、承認が必要；ゴール – 出力基準を設定し、エージェントが経路を決定します。
プラグイン・スキルによる拡張	マーケットプレイスのプラグイン（.piplugパッケージ）をインストールするか、独自開発が可能です。プラグインは新しいエージェントツール、ワークスペースパネル、MCP（Model Context Protocol）サーバー、サブエージェント、テーマなどを追加できます。
サブエージェント	背景で独立したタスク（探索、複数ファイル実装、リサーチ、テスト分析）を委任でき、親エージェントに報告します。
ローカル優先・プライバシー優先	すべての会話、設定、ログはローカルに保存（JSONL + SQLite）。APIキーはOSのキーチェーンに保存されます。PI‑Desktopアカウントの必須登録は不要、テレメトリも無し。モデルリクエストは、設定したプロバイダーに直接送信されます。

動作方法（概要アーキテクチャ）

• UI – Reactレンダラー（チャット、プロジェクトビュー、差分レビュー、設定）。Nodeとの統合は不要。
• Electronメインプロセス – デスクトップのライフサイクルを調整。
• Rustホストコア – 特権操作を管理：ファイルシステムアクセス、SQLite永続化、シークレットストレージ、権限強制。
• piエージェントサイドカー – 実際のLLM駆動エージェントループを実行、レスポンスをストリーミング、設定されたモデルプロバイダーと通信。
• モデルプロバイダー – クラウドまたはローカルエンドポイント。

導入方法

1. 最新のGitHubリリースから適切なインストーラーをダウンロード（macOS用：DMG/ZIP、Windows用：NSISまたはポータブルEXE、Linux用：AppImage/DEB/RPM）。
2. 設定 → モデル設定を開き、プロバイダーとAPIキーを追加（OSキーチェーンに保存）。
3. サイドバーからローカルプロジェクトフォルダを追加。
4. セッションを開始するためにエージェント、プラン、またはゴールモードを選択。
5. 変更を承認する前に、組み込みパネルで差分、コマンド出力、プレビューを確認。

製品の拡張

• プラグイン – 組み込みマーケットプレイスからインストールするか、.piplugファイルをアプリにドロップ。プラグインは隔離プロセスで実行されますが、信頼されたコードであり、新しいコマンド、UIパネル、バックグラウンドサービスを提供できます。
• スキル – エージェントが呼び出せる再利用可能な指示バンドル。
• MCPサーバー – Model Context Protocol経由でエージェントに外部ツール／サービスを公開。
• pi拡張 – 既存のpi‑CLI拡張はプラグインとしてラップされ、変更なしで実行可能。

現在の状態 – 初期プレビュー（v0.14.x）。コア機能（ワークスペース、ストリーミングエージェント、権限レイヤー、マルチモデル対応、プラグイン、サブエージェント、セッションインポート、チェックポイント）は動作しています。継続中の作業には、macOSリリース認証、インストーラーのアップグレード／ロールバック、強化されたセッション回復、より厳格なプラグインサンドボックス、広範なUIテストカバレッジが含まれます。

開発 – Node ≥22.19、pnpm ≥10、安定したRustツールチェーンでローカルビルド。通常のワークフロー：

git clone https://github.com/vastsa/PI-Desktop.git
cd PI-Desktop
pnpm install
cargo build -p host-core
pnpm build:js
pnpm dev

検証には pnpm typecheck、pnpm lint、pnpm test を実行してください。

ライセンス – GNU LGPL v3。

---

TL;DR: PI‑Desktopは、任意のローカルコードベース上でLLM駆動のコーディングエージェントを実行できる本格的でオープンソースのデスクトップ環境です。モデル、権限、拡張のすべてを完全に制御でき、すべてのデータはあなたのマシン上に保持されます。