@ludi-uni/pi-console

Local-first web console for Pi sessions and execution timelines

Packages

Package details

extension

Install @ludi-uni/pi-console from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@ludi-uni/pi-console

Package: @ludi-uni/pi-console
Version: 0.5.3
Published: Oct 24, 2026
Downloads: 1,672/mo · 303/wk
Author: ludi-uni
License: MIT
Types: extension
Size: 2.9 MB
Dependencies: 6 dependencies · 0 peers

Pi manifest JSON

{
  "extensions": [
    "./extensions/pi-console.mjs"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

Pi Console

English

Pi の会話と実行状況を、Windows の PC やスマートフォンのブラウザーで確認・操作するためのローカル優先の Web コンソールです。Node.js 24 以降、互換性のある Pi（安定版 0.99.2〜1.4.0）が必要です。Pi の TUI と同じ会話画面ではなく、Console が専用の SDK ワーカーで別の Pi セッションを管理します。互換性は最新版 1.4.0 で検証済みです。範囲内の中間バージョンは semver の安定版として許可していますが、すべてのバージョンを個別に実行確認したわけではありません。

安全上の注意：標準モードは認証なしで 127.0.0.1 にだけ接続します。LAN やインターネットへ直接公開しないでください。遠隔利用には Cloudflare Tunnel + Access の設定が必要です。

旧版から更新する場合：以前の Windows スタートアップ版は、npm の更新時に消える場所へワークスペース登録を保存していました。更新する前にバックアップと移行手順を実行してください。更新後には旧データを回収できない場合があります。

すぐに使う

Windows PC に Node.js 24 以降と互換性のある Pi（安定版 0.99.2〜1.4.0）を用意します。Pi でモデルを利用するための設定も必要です。

flowchart LR
  A["Windows PC<br/>Node.js + Pi"] --> B["PowerShell<br/>Pi Console をインストール"]
  B --> C["Pi<br/>再読み込み → /pi-console"]
  C --> D["PC のブラウザー<br/>表示されたローカル URL"]
  D --> E["Workspace → New Session → Chat"]

1. 公開版をインストールする

PowerShell で実行します。@latest は npm で公開済みの版を指します。公開版の番号を確認してからインストールできます。

node --version
pi --version
npm view @ludi-uni/pi-console version
pi install npm:@ludi-uni/pi-console@latest
pi list

npm の公開版より新しいこのリポジトリのソースを使う場合はローカル導入をご覧ください。インストールしただけでは Web サーバーは起動しません。

2. Pi から起動する

Pi を再起動するか、Pi の入力欄で以下を順に実行します（PowerShell のコマンドではありません）。

/reload
/pi-console

Pi が表示した URL（例：http://127.0.0.1:31717）を同じ PC のブラウザーで開きます。ポートが異なる場合は Pi の表示を優先してください。127.0.0.1 は接続した端末自身を指すため、その URL をスマートフォンに入力しても PC には接続できません。スマートフォンなどからの遠隔利用は Cloudflare Tunnel + Accessを設定してください。

Pi からの起動と Windows スタートアップは、通常 ~/.pi/agent/pi-console/.env を明示的に読み込みます。Cloudflare 用の設定を npm パッケージの外に保持できます。配置・優先順位・再起動方法は起動時の .env 設定をご覧ください。

サーバーは独立したバックグラウンドプロセスです。Pi を終了・/reload しても動き続け、/pi-console status|stop|restart（または任意のディレクトリーから scripts\pi-console.ps1 <コマンド>／node package/pi-console.mjs <コマンド>）で同じサーバーを管理します。restart は進行中の Web セッションを中断します。旧版で起動されたサーバーは報告のみで、自動的には停止しません。

3. 最初のセッションを作る

Workspaces で PC 上の作業フォルダーを選ぶか、Add a workspace から登録します。
New Session を押します。初回は Pi の拡張機能の読み込みに最大約1分かかる場合があります。
Chat でモデルを確認し、指示を送ります。送信すると選択したモデルのプロバイダー料金が発生する場合があります。

画面例（モバイル幅・デモ用ワークスペースとモデル。表示は設定により異なります）：

ワークスペースを登録	新しいセッションの Chat

最初に Server ready · no Pi session と表示されるのは、セッションを選ぶ前の正常な状態です。画面の使い方は使い方ガイドをご覧ください。

うまく起動しないとき

状況	確認すること
`pi` コマンドが見つからない	Pi のインストールと PowerShell の再起動を確認します。
`/pi-console` が使えない	Pi で `/reload` を実行するか Pi を再起動し、`pi list` で登録を確認します。
ブラウザーから接続できない	`/pi-console status` でサーバーの状態とポートを確認し、表示された URL を同じ PC で開きます。
セッションの起動が失敗する	画面のエラーを確認し、New Session を再試行します。繰り返す場合は運用・開発ガイドを参照してください。

ソースからの導入、単独の npm start、保存先や起動設定は運用・開発ガイドにまとめています。

目的別ガイド

やりたいこと	説明
会話、ファイルのプレビュー、実行状況を使う	使い方
データの保存先、起動設定、テストを確認する	運用・開発ガイド
旧版から安全に更新する	更新前のバックアップと移行
保護された遠隔アクセスを設定する	Cloudflare Tunnel + Access（英語）
内部設計を調べる	設計資料への案内

任意のペット素材

フィオ（素材の権利表示：DOLL Project / Ludi）は package/pets/fio/ に画像と設定を同梱しています。画像にはソフトウェアの MIT License ではなく別途 Fio Character Asset License が適用されます。Codex やユーザー領域のパッケージなしで利用できます（8 列 × 11 行、バージョン 2）。Codex 公式の組み込みペット画像は配布していません。Pi Console は OpenAI と無関係の独立したプロジェクトであり、OpenAI の承認を受けていません。サーバーの ~/.pi-console/pets、~/.codex/pets、従来の Pi agent の保存先も検索し、カスタムパッケージを優先します。設定 → ペットで保存元・種類の選択と再検索ができます。利用可能な画像がない場合はペットを表示しません。利用権のある素材だけを使用してください。

ソースコードは MIT License です。依存関係と素材の権利については配布時の注意をご確認ください。