ayuayue/PiDeck

PiDeck – Pi & DSH コーディングエージェント用デスクトップワークベンチ

概要

• PiDeck は、pi コーディングアシスタント CLI および DSH (DeepSeek Harness) 用のグラフィカルシェルとして機能するオープンソースのデスクトップアプリケーション（Electron + React/TypeScript 製）です。pi を置き換えるものではなく、pi（または DSH）プロセスを rpc モードで起動し、複数のプロジェクトと複数のエージェントセッションを管理するための統合 UI を提供するだけです。

対象者

• ローカルで pi または DeepSeek エージェントを使用していて、次のことを実現したい開発者：
  • 複数のコードベース用に個別のワークスペースを維持する。
  • 会話履歴を閲覧、検索、エクスポートする。
  • UI から離れることなく、Git ステータスの確認、ファイルの編集、ターミナルの実行、モデルの設定を行う。
  • 古い Codex/Claude セッションファイルをインポートして、PiDeck 互換の履歴に変換する。

主な機能

領域	PiDeck の機能
マルチプロジェクトワークスペース	ローカルプロジェクトフォルダの追加、並べ替え、切り替えが可能。各プロジェクトは、分離された独自の pi RPC プロセスを実行します。
セッション管理	セッションの作成、名前変更、複製、削除、エクスポート（HTML）、再開が可能。pi と DSH の両バックエンドをサポートし、さらに OpenAI 互換の画像 API と通信する「画像生成」モードもサポートします。
リッチな入力ヘルパー	@-ファイル参照、/ コマンドパレット、! シェル実行 – すべて単一のチャットボックスから利用可能。
ファイル & Git 統合	Git ステータスバッジ付きのファイルツリー、組み込みエディタ、外部エディタのショートカット、Git ブランチセレクター、アクティブなエージェントに連動するターミナルドック。
モデル & 資格情報 UI	models.json、auth.json、settings.json 用のビジュアルエディタ。ワンクリック接続テスト、プロバイダーレベルの使用量と残高表示、プロキシ設定。
拡張機能 & スキルストア	組み込み拡張機能の有効化/無効化、コミュニティの スキル および プロンプト マーケットプレイスの閲覧、中国語プロンプトコレクション（XuePrompt）のインストール。
デスクトップの仕上げ	システムトレイ、テーマ切り替え、デスクトップペットマスコット、トースト通知、Feishu ボット同期、LAN アクセス可能な Web UI、プロセスモニター & ログビューア。
DSH 深い統合	組み込み DSH ホストが Electron ユーティリティプロセスとして実行されます（追加ポートなし）。完全なセッションブラウジング、コマンド補完、使用統計、資格情報編集が提供されます。

仕組み

• Electron の メインプロセス は、セッションごとに個別の pi --mode rpc プロセスと、組み込みの DSH ホストを起動します。通信は stdio JSON-RPC を介して行われ、エージェントは分離された状態に保たれます。
• プリロードスクリプト は、contextBridge を介して React レンダラーに限定された window.piDesktop API を公開します。
• レンダラー（React）は、プロジェクトリスト、チャットタイムライン、ファイルエクスプローラー、Git パネル、ターミナルドック、設定などを表示します。
• 設定ファイルは直接編集されますが、ビジュアル UI を介して行われます。変更は、対応するエージェントが再起動した後に有効になります。

はじめに

1. pi CLI をインストールし、PATH に含めます（pi --version）。
2. GitHub リリースページから適切なインストーラーをダウンロードします（Windows/macOS/Linux）。別途 PiDeck Dev プレリリースチャンネルも提供されています。
3. アプリを実行し、プロジェクトフォルダを追加して、新しい pi または DSH セッションを作成します。
4. サイドパネルを使用して models.json などを編集するか、組み込みターミナルを開いてコマンドを実行します。

開発

• Node 20+ と npm が必要です。
• 一般的なワークフロー：npm install && npm run dev でホットリロード対応の Electron ウィンドウを起動します。
• ビルドコマンド（npm run dist:*）は各プラットフォーム用のインストーラーを生成します。dist:*:dev は並行開発チャンネルを作成します。

ライセンス & コミュニティ

• MIT ライセンスで、活発な中国語コミュニティ（QQ/WeChat グループ）と、GitHub 上の公開 issue トラッカーがあります。

要するに、PiDeck は、複数のローカル AI コーディングエージェントを並行して実行し、会話を整理し、コードベースやツールと緊密に統合できる、フル機能のデスクトップ IDE スタイルのラッパーです。

---

リポジトリメタデータ

• ステータス：実験的（v0.9.0、2026-10-14）
• プラットフォーム：Windows | macOS | Linux
• コアテクノロジー：Electron 38、React 19、TypeScript
• ライセンス：MIT

---

上記の詳細はすべて、プロジェクトの README から直接取得されています。