Xpropel/Pi-Remote

これは何？

主な機能

• 01piのターミナル出力、ツール呼び出し、ステータスをリアルタイムでブラウザーにミラーリング
• 02piの処理中に、キューイングまたは割り込み指示を使ってリモートからメッセージを送信
• 03リモートでのモデルやthinking levelの切り替え、手動でのコンテキスト圧縮、セッションツリーの移動
• 04QRコードによるデバイス連携と、複数マシンの接続に対応
• 05オンデマンドで起動できるCloudflare Tunnelを備えたサーバーレスLANモード
• 06複数のビジュアルスキンを備えた、デスクトップ用とモバイル用の別レイアウト

ユースケース

• 長時間実行中のコーディングエージェントのタスクをスマートフォンから確認する
• デスクを離れている間にpiからのプロンプトに応答する
• 1つのブラウザーダッシュボードから複数マシン上のpiセッションを操作する

クイックスタート

1. 1

   pi ターミナルコーディングエージェントをインストールします（Node 22.18 以降が必要です）

   npm install -g @earendil-works/pi-coding-agent
2. 2

   プロジェクトフォルダーに Pi-Remote の依存関係をインストールします

   npm install
3. 3

   お使いのマシンで relay を起動します（Web UI はポート 7002）

   npm run relay

使う前に知っておきたいこと

• !pi コーディングエージェントは別途インストールする必要があります。Pi-Remote には含まれていません。
• !ローカルループモードを除き、relay 経由で複数のデバイスから利用するには、自分で管理するサーバーが必要です。
• !個人での単一ユーザー利用を想定しており、複数ユーザー向けの権限管理システムはありません。
• !viewer token を持つ人は誰でも pi にメッセージやコマンドを送信できます。そのため、token は安全に管理してください。

収録されている特集

トピック

よくある質問

Pi-Remote とは？

piのターミナルコーディングエージェントを遠隔操作。セルフホストのリレー経由でライブセッションをブラウザーやスマートフォンに表示し、メッセージやコマンドを送信できます。 Pi-Remoteは、piの公式extension APIを通じて実行中のpiターミナルセッションに接続します。piのソースを変更したり、ターミナルの操作を奪ったりすることはありません。セッションはローカルのpiプロセスで実行され続け、ブラウザーにはそのリアルタイムミラーが表示されます。ブラウザーからメッセージの送信、モデルやthinking levelの切り替え、コンテキストの圧縮、セッションの作成やフォーク、セッションツリーの移動ができます。

Pi-Remote は無料で使えますか？ライセンスは？

Pi-Remote は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

Pi-Remote は今もメンテナンスされていますか？

活発にメンテナンス中。Pi-Remote の最終コミットは 2026年11月5日 です。

Pi-Remote は何に使えますか？

長時間実行中のコーディングエージェントのタスクをスマートフォンから確認する デスクを離れている間にpiからのプロンプトに応答する 1つのブラウザーダッシュボードから複数マシン上のpiセッションを操作する

Pi-Remote のインストール方法は？

pi ターミナルコーディングエージェントをインストールします（Node 22.18 以降が必要です）: npm install -g @earendil-works/pi-coding-agent プロジェクトフォルダーに Pi-Remote の依存関係をインストールします: npm install お使いのマシンで relay を起動します（Web UI はポート 7002）: npm run relay

Pi-Remote はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/Xpropel/Pi-Remote