agegr/pi-web

Pi Web – Pi coding-agent用ブラウザUI

概要 – Pi Webは、Pi coding-agent（コード用のコマンドラインAIアシスタント）を操作するためのローカルWebベースのインターフェースです。Pi CLIと同じ設定ファイルとセッションファイルを読み込むため、ブラウザウィンドウからセッションの閲覧、再開、分岐、モデル認証情報の管理、プロジェクトファイルの確認が可能です。

主な機能

• セッションワークスペース – プロジェクトごとにセッションを一覧表示し、使用統計（トークン、コスト、圧縮）を確認、名前変更、エクスポート、削除、および任意のメッセージから新しいブランチを作成できます。
• ファイルエクスプローラー – セッションが認識しているファイルを閲覧、新しいファイルのアップロード、Git diffの表示、および多くの形式（Markdown、ソースコード、画像、音声、PDF、DOCX）のライブリフレッシュ付きプレビューが可能です。
• Gitワークツリーサポート – 異なるワークツリーのチェックアウトを切り替えながら、セッションをリポジトリごとにグループ化できます。
• 設定パネル – UIを離れることなく、モデルプロバイダー、APIキー、プラグイン、スキルを追加または編集できます。
• 多言語UI – 英語、簡体字中国語、繁体字中国語に対応しており、ブラウザの言語設定から自動的に選択されます。

実行方法

1. Node 22.19以降をインストールします。
2. npx @agegr/pi-web@latest というワンライナーで起動します（または npm i -g @agegr/pi-web でグローバルインストール）。
3. ローカルサーバーが 127.0.0.1:30141 で起動し、デフォルトのブラウザが開きます。
4. まだモデルプロバイダーを設定していない場合は、Models パネルを開いてAPIキーを追加してください。

設定とセキュリティ

• ポート、ホスト名、アイドルタイムアウト、パスワード保護は、CLIフラグまたは環境変数（PI_WEB_PASSWORD、PI_WEB_IDLE_TIMEOUT_MS など）で制御可能です。
• デフォルトではlocalhostのみにバインドされます。ネットワーク上で公開する場合は、強力なパスワードとTLS用のリバースプロキシが必要です。
• UIは、Pi agentが認識している作業ディレクトリ内のファイルのみにアクセスし、ファイルシステム全体にはアクセスしません。

開発 – このリポジトリは、TypeScriptで書かれたNext.js + Reactアプリです。npm install && npm run dev を実行すると、ホットリロード付きの開発サーバーが起動します。テスト、型チェック、Lintingが提供されています。

対象ユーザー – Pi coding-agentを使用しており、コマンドラインを離れることなく、セッション、ファイル、モデル設定をよりリッチで視覚的な方法で管理したい方。

ライセンス – MIT。