Desktop app for the pi coding agent: streaming timeline, Git review with hunk staging, session tree, native UI for pi extensions. Windows · macOS · Linux. pi 编程 Agent 桌面客户端

pi Desktop – pi コーディングエージェント用 GUI

何であるか – pi Desktop はクロスプラットフォームのデスクトップアプリ（Windows、macOS、Linux）で、ターミナルから pi CLI で実行できる pi コーディングエージェントと対話できるようにします。新しいモデルを提供するものではなく、既存の pi SDK をバックグラウンドのワーカーで実行し、CLI で既に使っているセッション、Git ディフ、ファイルブラウジング、拡張機能のための視覚的 UI を提供します。

コア機能

機能	得られるもの
共有セッションストア	CLI とデスクトップの両方が `~/.pi/agent`（セッション、モデルログイン、`settings.json`、拡張機能）を読み書きします。フォルダを開けば、ターミナルで開始したのと同じセッションが即座に表示されます。
タイムラインビュー	エージェントの各ターン（思考、ツール呼び出し、ファイルの読み取り/編集）が、要約されたステップとして表示されます。編集は `+N −M` 行変更を示し、変更されたファイルカードをクリックすると差分が開きます。
レビューパネル	スコープ（単一ターン、全セッション、または完全な Git ツリー）を選択して Git 風の差分を表示できます。ハングスのステージ/アンステージや、行コメントを会話に返信できます。
ファイルパネル	チャットと並行してプロジェクトをブラウズできます。行をクリックすると `path:line` をコンポーザーに引用でき、ファイルのプレビュー、チャットへのドラッグアンドドロップが可能です。
コンポーザーショートカット	`@` でプロジェクトファイルを検索（`fd` により `.gitignore` を尊重）、`/` で pi コマンドと拡張機能登録コマンドの一覧表示、`Enter` で送信、`Alt+Enter` でフォローアップをキュー、`Shift+Enter` で改行。
並列セッション	各セッションは独自の Electron ワーカーで実行されるため、最初のターンが処理中でも、2つ目のターンを開始できます。
パネル	ツリー（セッションをツリーとして）、実行（モデル/思考レベルとトークン分割）、コンテキスト（トークン推定付きメッセージ）。
テーマと外観	ライト/ダークのプリセット、カスタム CSS、5種類のアイコンセット、密度スケーリング、`pi-theme-v1` / `codex-theme-v1` 文字列からのインポート。
拡張機能	既存のターミナルインストール済み pi 拡張機能はそのまま読み込まれます。UI ダイアログ、ツールカード、`/commands` は宣言的アダプター（36種類内蔵）によりネイティブパネルにマッピングされます。JSON ファイルでアダプターを追加・上書き可能。
音声入力	ChatGPT のエンドポイントを使用した内蔵音声認識（API キー不要）またはカスタム `codex-asr` サービス。
WSL ランタイム（Windows）	ワーカーは選択した WSL ディストリビューション内で実行可能で、Git とファイルプレビューを Linux 側で維持します。

どんな人が使うべきか？

pi CLI を既に使っている開発者で、コード変更のレビュー、セッションツリーのナビゲーション、Git ハングスのステージングをアプリ内ですべて完結させたい人。
同じ ~/.pi/agent ディレクトリを共有するチーム – デスクトップとターミナルが同期されるため、同僚があなたが開始したセッションを引き継ぐことができます。
純粋なターミナル出力よりも、タイムライン、差分、ファイルプレビューといった視覚的フィードバックを好む人。

はじめ方（README から）

ダウンロード – Releases ページから OS に応じたインストーラーを取得（Windows: .exe/ポータブル、macOS: .dmg/.zip、Linux: .AppImage または .deb）。
フォルダを開く – これがエージェントの作業ディレクトリになります。Conversations の隣にある + ボタンで一時的なチャットを作成できます。
セッションを選択 – 既存のターミナルセッションが表示されます。+ をクリックして新しいセッションを開始。
プロンプトを送信 – Enter で送信、Shift+Enter で改行。エージェントが実行中は、Enter でターンを制御、Alt+Enter でフォローアップをキュー。
UI を探索 – レビュー、実行、コンテキスト、ツリー、ファイルパネルは右サイドバーにあり、ドラッグでサイズ変更可能。

技術概要（開発者向け）

スタック: Electron 43, React 18, TypeScript, Tailwind, Zustand, i18next, @earendil-works/pi-coding-agent。
アーキテクチャ: メインプロセスは IPC を処理し、セッションごとに worker を生成。各ワーカーは pi SDK を実行（ローカルまたは WSL 内）。レンダラーは SDK に直接接続しません。
ビルド: npm install → npm run dev（開発）、npm run build（本番バンドル）、npm run package（electron-builder によるインストーラー生成）。
テスト: 単体テスト、スクリプト、型チェック、Lint スクリプトが提供されています。

ライセンスとサポート

ライセンス: MIT。
サポート: LinuxDo コミュニティ、GitHub Issues、スポンサーシップ QR コード。

結論 – pi Desktop は既存の pi コーディングエージェントを完全に機能する GUI ラッパーとして提供し、タイムライン可視化、Git 風レビュー、ファイルブラウジング、並列セッション、拡張機能サポートを実現しながら、CLI ワークフローと完全に互換性を持ちます。

justhil/pi-app