@pricening/pi-web 0.9.8 → 0.9.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (83) hide show
  1. package/.next/BUILD_ID +1 -1
  2. package/.next/app-path-routes-manifest.json +12 -12
  3. package/.next/build-manifest.json +2 -2
  4. package/.next/prerender-manifest.json +3 -3
  5. package/.next/required-server-files.js +2 -2
  6. package/.next/required-server-files.json +2 -2
  7. package/.next/server/app/_global-error/page_client-reference-manifest.js +1 -1
  8. package/.next/server/app/_global-error.html +1 -1
  9. package/.next/server/app/_global-error.rsc +1 -1
  10. package/.next/server/app/_global-error.segments/_full.segment.rsc +1 -1
  11. package/.next/server/app/_global-error.segments/_global-error/__PAGE__.segment.rsc +1 -1
  12. package/.next/server/app/_global-error.segments/_tree.segment.rsc +1 -1
  13. package/.next/server/app/_not-found/page_client-reference-manifest.js +1 -1
  14. package/.next/server/app/_not-found.html +1 -1
  15. package/.next/server/app/_not-found.rsc +3 -3
  16. package/.next/server/app/_not-found.segments/_full.segment.rsc +3 -3
  17. package/.next/server/app/_not-found.segments/_not-found/__PAGE__.segment.rsc +3 -3
  18. package/.next/server/app/_not-found.segments/_tree.segment.rsc +2 -2
  19. package/.next/server/app/api/agent/[id]/events/route.js +2 -2
  20. package/.next/server/app/api/app-update/route.js +1 -1
  21. package/.next/server/app/api/auth/api-key/[provider]/route.js +1 -1
  22. package/.next/server/app/api/auth/login/[provider]/route.js +2 -2
  23. package/.next/server/app/api/auth/logout/[provider]/route.js +1 -1
  24. package/.next/server/app/api/auth/providers/route.js +1 -1
  25. package/.next/server/app/api/models/route.js +1 -1
  26. package/.next/server/app/api/plugins/check/route.js +1 -1
  27. package/.next/server/app/api/plugins/route.js +1 -1
  28. package/.next/server/app/api/provider-usage/query/route.js +1 -1
  29. package/.next/server/app/api/sessions/[id]/auto-name/route.js +4 -3
  30. package/.next/server/app/api/sessions/[id]/auto-name/route.js.nft.json +1 -1
  31. package/.next/server/app/api/sessions/[id]/route.js +1 -1
  32. package/.next/server/app/api/skills/install/route.js +1 -1
  33. package/.next/server/app/api/skills/search/route.js +1 -1
  34. package/.next/server/app/api/skills/update/route.js +1 -1
  35. package/.next/server/app/index.html +1 -1
  36. package/.next/server/app/index.rsc +5 -5
  37. package/.next/server/app/index.segments/__PAGE__.segment.rsc +5 -5
  38. package/.next/server/app/index.segments/_full.segment.rsc +5 -5
  39. package/.next/server/app/index.segments/_tree.segment.rsc +2 -2
  40. package/.next/server/app/login/page_client-reference-manifest.js +1 -1
  41. package/.next/server/app/login.html +1 -1
  42. package/.next/server/app/login.rsc +4 -4
  43. package/.next/server/app/login.segments/_full.segment.rsc +4 -4
  44. package/.next/server/app/login.segments/_tree.segment.rsc +2 -2
  45. package/.next/server/app/login.segments/login/__PAGE__.segment.rsc +4 -4
  46. package/.next/server/app/page.js +20 -20
  47. package/.next/server/app/page_client-reference-manifest.js +1 -1
  48. package/.next/server/app-paths-manifest.json +12 -12
  49. package/.next/server/chunks/2243.js +1 -1
  50. package/.next/server/chunks/3573.js +1 -1
  51. package/.next/server/chunks/4353.js +1 -0
  52. package/.next/server/chunks/5582.js +2 -2
  53. package/.next/server/chunks/6429.js +7 -5
  54. package/.next/server/instrumentation.js +1 -1
  55. package/.next/server/instrumentation.js.nft.json +1 -1
  56. package/.next/server/middleware-build-manifest.js +1 -1
  57. package/.next/server/next-font-manifest.js +1 -1
  58. package/.next/server/next-font-manifest.json +1 -1
  59. package/.next/server/pages/404.html +1 -1
  60. package/.next/server/pages/500.html +1 -1
  61. package/.next/server/server-reference-manifest.json +1 -1
  62. package/.next/static/chunks/1278-3bb20200f46a509d.js +1 -0
  63. package/.next/static/chunks/app/layout-815fddea152adfd1.js +1 -0
  64. package/.next/static/chunks/app/page-5d1e39cad0da02b2.js +283 -0
  65. package/.next/static/css/{f4a799a04a7a8a76.css → bcb1a8e544e62fd8.css} +1 -1
  66. package/.next/trace +40 -39
  67. package/.next/trace-build +1 -1
  68. package/README.ja.md +7 -130
  69. package/README.md +51 -123
  70. package/README.ru.md +7 -130
  71. package/README.zh-CN.md +51 -77
  72. package/bin/pi-web-node-args.js +11 -0
  73. package/bin/pi-web.js +3 -1
  74. package/next.config.ts +7 -0
  75. package/package.json +2 -2
  76. package/public/sw.js +23 -2
  77. package/public/sw.test.mjs +107 -1
  78. package/.next/server/chunks/2349.js +0 -1
  79. package/.next/static/chunks/1278-4e101e127edaae15.js +0 -1
  80. package/.next/static/chunks/app/layout-defc84c8112fb814.js +0 -1
  81. package/.next/static/chunks/app/page-89f22c7c0fc4ff07.js +0 -283
  82. /package/.next/static/{v2ujhGjLkjIUa9TUL8cVR → SW_diFgxch2hiN4O6LYY0}/_buildManifest.js +0 -0
  83. /package/.next/static/{v2ujhGjLkjIUa9TUL8cVR → SW_diFgxch2hiN4O6LYY0}/_ssgManifest.js +0 -0
package/.next/trace-build CHANGED
@@ -1 +1 @@
1
- [{"name":"run-webpack","duration":31493371,"timestamp":119579551,"id":14,"parentId":1,"tags":{},"startTime":1789653306530,"traceId":"3252bd19cb6a0282"},{"name":"run-typescript","duration":13105718,"timestamp":151077733,"id":8480,"parentId":1,"tags":{},"startTime":1789653338028,"traceId":"3252bd19cb6a0282"},{"name":"static-check","duration":2188115,"timestamp":164198876,"id":8483,"parentId":1,"tags":{},"startTime":1789653351149,"traceId":"3252bd19cb6a0282"},{"name":"static-generation","duration":5409582,"timestamp":166648492,"id":8613,"parentId":1,"tags":{},"startTime":1789653353599,"traceId":"3252bd19cb6a0282"},{"name":"collect-build-traces","duration":39528373,"timestamp":166389839,"id":8610,"parentId":1,"tags":{},"startTime":1789653353340,"traceId":"3252bd19cb6a0282"},{"name":"telemetry-flush","duration":60,"timestamp":205921743,"id":8622,"parentId":1,"tags":{},"startTime":1789653392872,"traceId":"3252bd19cb6a0282"},{"name":"next-build","duration":86490042,"timestamp":119431772,"id":1,"tags":{"buildMode":"default","version":"16.3.5","bundler":"webpack","has-custom-webpack-config":"false","use-build-worker":"true"},"startTime":1789653306382,"traceId":"3252bd19cb6a0282"}]
1
+ [{"name":"run-webpack","duration":32242823,"timestamp":205465434,"id":14,"parentId":1,"tags":{},"startTime":1789904772716,"traceId":"d2e3398af39774d1"},{"name":"run-typescript","duration":13556892,"timestamp":237712073,"id":8491,"parentId":1,"tags":{},"startTime":1789904804962,"traceId":"d2e3398af39774d1"},{"name":"static-check","duration":2458517,"timestamp":251283669,"id":8494,"parentId":1,"tags":{},"startTime":1789904818534,"traceId":"d2e3398af39774d1"},{"name":"static-generation","duration":5633017,"timestamp":254055350,"id":8624,"parentId":1,"tags":{},"startTime":1789904821306,"traceId":"d2e3398af39774d1"},{"name":"collect-build-traces","duration":40345027,"timestamp":253745159,"id":8621,"parentId":1,"tags":{},"startTime":1789904820995,"traceId":"d2e3398af39774d1"},{"name":"telemetry-flush","duration":63,"timestamp":294093626,"id":8633,"parentId":1,"tags":{},"startTime":1789904861344,"traceId":"d2e3398af39774d1"},{"name":"next-build","duration":88797634,"timestamp":205296068,"id":1,"tags":{"buildMode":"default","version":"16.3.5","bundler":"webpack","has-custom-webpack-config":"false","use-build-worker":"true"},"startTime":1789904772546,"traceId":"d2e3398af39774d1"}]
package/README.ja.md CHANGED
@@ -1,134 +1,11 @@
1
- # Pi Web
1
+ # @pricening/pi-web
2
2
 
3
- [English](./README.md) | [简体中文](./README.zh-CN.md) | [Русский](./README.ru.md)
3
+ This repository is a **personal fork** of [agegr/pi-web](https://github.com/agegr/pi-web).
4
4
 
5
- [pi コーディングエージェント](https://github.com/earendil-works/pi) のローカルブラウザー UI です。Pi Web は pi と同じローカル設定とセッションファイルを使用し、ブラウザーから会話の検索と再開、エージェントの実行、モデルやリソースの設定、プロジェクトファイルの確認を行えます。
5
+ Please read:
6
6
 
7
- ![構造化された Markdown、ツール呼び出し、プロジェクトナビゲーションとともに pi セッションを表示する Pi Web](https://raw.githubusercontent.com/agegr/pi-web/main/docs/screenshot2.png)
7
+ - [README.md](./README.md) (English)
8
+ - [README.zh-CN.md](./README.zh-CN.md) (简体中文)
9
+ - Maintenance rules: [docs/FORK.md](./docs/FORK.md)
8
10
 
9
- ## 機能
10
-
11
- - **セッションワークスペース**:プロジェクトごとに会話を閲覧、再開、名前変更、エクスポート、削除し、実行状態、コンテキスト使用量、コスト、コンパクション情報を確認できます。
12
- - **2 種類の分岐**:**New session** は以前のメッセージから独立したセッションファイルを作成し、**Edit from here** は現在のセッション内にブランチを作成します。
13
- - **プロジェクトファイルツール**:ファイルの閲覧とアップロード、Git Diff の確認、ソース、Markdown、画像、音声、PDF、DOCX のプレビューに対応し、変更時は自動更新されます。
14
- - **Git worktree**:同じリポジトリのセッションをまとめたまま、サイドバーからチェックアウトを切り替えられます。
15
- - **Web での設定**:Pi Web を離れずに、Provider のログインと API Key、モデル、モデルテスト、プラグインパッケージ、スキルを管理できます。
16
- - **英語、簡体字中国語、繁体字中国語の UI**:初回はブラウザーの言語に従い、トップバーから言語を切り替えられます。
17
-
18
- ## クイックスタート
19
-
20
- Pi Web には Node.js 22.19.0 以降が必要です。`node --version` でバージョンを確認してから、次を実行します:
21
-
22
- ```bash
23
- npx @agegr/pi-web@latest
24
- ```
25
-
26
- サーバーの準備が整うと、CLI はブラウザーを自動的に開こうとします。開かない場合は [http://127.0.0.1:30141](http://127.0.0.1:30141) にアクセスしてください。Pi Web はデフォルトで `127.0.0.1` のみをリッスンします。
27
-
28
- モデル Provider が未設定の場合は、**Models** パネルを開いてログインするか API Key を追加してください。
29
-
30
- `pi-web` コマンドをグローバルにインストールする場合:
31
-
32
- ```bash
33
- npm install -g @agegr/pi-web@latest
34
- pi-web
35
- ```
36
-
37
- 更新時は、実行中のプロセスを `Ctrl+C` で停止してから同じインストールコマンドを再実行します。アンインストールするには `npm uninstall -g @agegr/pi-web` を実行します。
38
-
39
- ## 設定
40
-
41
- ポートとホスト名では、コマンドラインオプションが対応する環境変数より優先されます。`--no-open` と `PI_WEB_NO_OPEN=1` は、どちらを指定してもブラウザーの自動起動が無効になります。`pi-web --help`(または `-h`)で起動オプションを表示して終了します。未知のオプションはエラーで終了します。
42
-
43
- | オプションまたは環境変数 | 用途 | デフォルト |
44
- | --- | --- | --- |
45
- | `--help`、`-h` | 起動オプションを表示して終了 | — |
46
- | `--port <port>`、`-p <port>`、または `PORT` | サーバーポート | `30141` |
47
- | `--hostname <host>`、`-H <host>`、または `PI_WEB_HOSTNAME` | バインドするホスト名 | `127.0.0.1` |
48
- | `--no-open` または `PI_WEB_NO_OPEN=1` | ブラウザーを自動的に開かない | 自動的に開く |
49
- | `PI_WEB_ALLOWED_HOSTS` | 追加で許可するプロキシまたはカスタムホスト名。複数指定はカンマ区切りで完全一致 | 未設定 |
50
- | `PI_WEB_PASSWORD` | ブラウザーのパスワードログインを有効化。API はユーザー名 `pi` の Basic Auth も利用可能 | 認証なし |
51
-
52
- 例:
53
-
54
- ```bash
55
- pi-web --help
56
- pi-web -p 8080 -H 0.0.0.0 --no-open
57
- ```
58
-
59
- ### リモートアクセス
60
-
61
- ループバック以外のアドレスにバインドすると、高い権限の操作を実行できるエージェントがネットワークに公開されます。信頼できる LAN で使用する場合も、十分に長いランダムなパスワードを設定してください:
62
-
63
- ```bash
64
- PI_WEB_PASSWORD='十分に長いランダムなパスワード' pi-web --hostname 0.0.0.0
65
- ```
66
-
67
- パスワード認証は接続を暗号化しません。平文 HTTP で Pi Web をインターネットに公開せず、信頼できるリバースプロキシによる HTTPS または信頼できる VPN を使用してください。リバースプロキシが外部ホスト名を転送する場合は、その名前を完全一致で `PI_WEB_ALLOWED_HOSTS` に追加します。この許可リストは Pi Web のバインド先を変更しません。
68
-
69
- ### HTTP プロキシ
70
-
71
- サーバー側のモデルリクエストと API リクエストは、標準の `HTTP_PROXY`、`HTTPS_PROXY`、`NO_PROXY` 環境変数を使用します。
72
-
73
- macOS または Linux:
74
-
75
- ```bash
76
- HTTP_PROXY=http://127.0.0.1:7890 \
77
- HTTPS_PROXY=http://127.0.0.1:7890 \
78
- NO_PROXY=localhost,127.0.0.1 \
79
- npx @agegr/pi-web@latest
80
- ```
81
-
82
- Windows PowerShell:
83
-
84
- ```powershell
85
- $env:HTTP_PROXY = "http://127.0.0.1:7890"
86
- $env:HTTPS_PROXY = "http://127.0.0.1:7890"
87
- $env:NO_PROXY = "localhost,127.0.0.1"
88
- npx @agegr/pi-web@latest
89
- ```
90
-
91
- ## 注意事項
92
-
93
- - **エージェントデータ**:Pi Web はデフォルトで `~/.pi/agent` の pi データを読み込みます。セッションファイルは `sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl` にあります。別の pi エージェントディレクトリを使用するには `PI_CODING_AGENT_DIR` を設定してください。
94
- - **ファイルシステムへのアクセス**:Pi Web はエージェントデータディレクトリと、セッションに記録された作業ディレクトリを読み取れる必要があります。既存の pi セッションを共有する場合は、pi と同じファイルシステム環境で Pi Web を実行してください。
95
- - **共有設定**:Models パネルは pi のモデル、設定、認証情報ストレージを使用するため、変更は両方のインターフェースに反映されます。
96
- - **ファイルアクセスの範囲**:ファイルブラウザーは、Pi Web で選択した作業ディレクトリと、既知のプロジェクトまたはセッションルートに限定されます。汎用のファイルシステムブラウザーではありません。
97
- - **Git worktree**:スイッチャーの表示条件、worktree の作成、削除時の動作については [Worktrees in Pi Web](./docs/worktrees.md) を参照してください。
98
-
99
- ## 開発
100
-
101
- ```bash
102
- npm install
103
- npm run dev
104
- ```
105
-
106
- 開発サーバーは [http://127.0.0.1:30141](http://127.0.0.1:30141) で動作します。一般的なチェックは次のコマンドで実行します:
107
-
108
- ```bash
109
- npm test
110
- node_modules/.bin/tsc --noEmit
111
- npm run lint
112
- ```
113
-
114
- 通常の開発中は `next build` または `npm run build` を実行しないでください。`.next/` に書き込まれ、開発サーバーに影響する可能性があります。ビルドはリリース作業時にのみ実行してください。
115
-
116
- コントリビューター向けガイド:[Internationalization](./docs/i18n.md) と [Release process](./docs/release.md)。
117
-
118
- ## リポジトリ構成
119
-
120
- ```text
121
- app/ Next.js UI と API ルート
122
- components/ React UI コンポーネント
123
- hooks/ クライアントの状態と操作に関する hooks
124
- lib/ セッション、エージェント、モデル、ファイル、Git、セキュリティのロジック
125
- public/ 静的アセットと PWA ファイル
126
- bin/ npm CLI エントリポイントと起動オプションの解析
127
- docs/ ユーザーおよびコントリビューター向けの個別ガイド
128
- ```
129
-
130
- アーキテクチャの説明と詳細なファイルマップについては [AGENTS.md](./AGENTS.md) を参照してください。
131
-
132
- ## ライセンス
133
-
134
- [MIT](./LICENSE)
11
+ npm package: **`@pricening/pi-web`** (not `@agegr/pi-web`).
package/README.md CHANGED
@@ -1,44 +1,59 @@
1
- # Pi Web
1
+ # @pricening/pi-web
2
2
 
3
- [中文文档](./README.zh-CN.md) | [日本語](./README.ja.md) | [Русский](./README.ru.md)
3
+ [简体中文](./README.zh-CN.md)
4
4
 
5
- Local browser UI for the [pi coding agent](https://github.com/earendil-works/pi). Pi Web uses the same local configuration and session files as pi, so you can browse and resume conversations, run agent turns, configure models and resources, and inspect project files from a browser.
5
+ A **personal fork** of [agegr/pi-web](https://github.com/agegr/pi-web), the local browser UI for the [pi coding agent](https://github.com/earendil-works/pi).
6
6
 
7
- ![Pi Web displaying a pi session with structured Markdown, tool calls, and project navigation](https://raw.githubusercontent.com/agegr/pi-web/main/docs/screenshot2.png)
7
+ ## Why this fork exists
8
8
 
9
- ## Features
9
+ Upstream Pi Web is excellent and very active. This repository exists so I can add **advanced features I actually use** without waiting for (or expecting) them to land upstream — historically, session-organization PRs such as pin/favorite have been closed in favor of a planned redesign.
10
10
 
11
- - **Session workspace**: browse, resume, rename, export, and delete conversations grouped by project, with running state, context usage, cost, and compaction details.
12
- - **Two ways to branch**: **New session** creates an independent session file from an earlier message; **Edit from here** creates a branch inside the current session.
13
- - **Project file tools**: browse and upload files, inspect Git diffs, and preview source, Markdown, images, audio, PDFs, and DOCX files with automatic refresh.
14
- - **Git worktrees**: switch checkouts from the sidebar while keeping sessions from the same repository grouped together.
15
- - **Web-based configuration**: manage provider login and API keys, models, model tests, plugin packages, and skills without leaving Pi Web.
16
- - **English, Simplified Chinese, and Traditional Chinese UI**: Pi Web follows the browser language initially and provides a language switcher in the top bar.
11
+ The fork is meant to **keep following upstream**, not to replace it:
17
12
 
18
- ## Quick Start
13
+ | | |
14
+ |---|---|
15
+ | Upstream | [agegr/pi-web](https://github.com/agegr/pi-web) — fetch only |
16
+ | This repo | [PriceNing/pi-web](https://github.com/PriceNing/pi-web) |
17
+ | npm package | **`@pricening/pi-web`** (not `@agegr/pi-web`) |
18
+ | Upstream baseline | `package.json` → `forkedFrom` |
19
19
 
20
- Pi Web requires Node.js 22.19.0 or newer. Check your version with `node --version`, then run:
20
+ Install the official package if you want an unmodified Pi Web. Install this package only if you want the extra features below.
21
21
 
22
- ```bash
23
- npx @agegr/pi-web@latest
24
- ```
22
+ How we stay in sync, version, and publish: **[docs/FORK.md](./docs/FORK.md)** (the maintenance spec).
25
23
 
26
- The CLI opens a browser after the server is ready. If it does not, open [http://127.0.0.1:30141](http://127.0.0.1:30141). Pi Web listens only on `127.0.0.1` by default.
24
+ ## Extra features (this fork)
27
25
 
28
- If no model provider is configured yet, open the **Models** panel to sign in or add an API key.
26
+ - **Server-side pins** for projects and sessions. Pins live under `~/.pi/agent/pi-web/pins.json`, so every browser hitting the same server (PC / phone / tablet) sees the same order. Pinned items sort first; within a group they stay ordered by recent activity.
27
+ - **Project archive**. The sidebar “project” row is only a grouping of sessions, not a first-class pi object. Archive hides that group from the sidebar without moving session files. Manage / unarchive / bulk-delete those chats from **Settings → Archives**. Deleting sessions never deletes the code folder on disk.
28
+
29
+ Everything else is upstream Pi Web: same `~/.pi/agent` sharing with the local pi CLI, same session files, same models/auth/skills.
30
+
31
+ ## Quick start
29
32
 
30
- To install the `pi-web` command globally:
33
+ Requires Node.js 22.19.0 or newer (`node --version`).
31
34
 
32
35
  ```bash
33
- npm install -g @agegr/pi-web@latest
36
+ npm install -g @pricening/pi-web@latest --registry=https://registry.npmjs.org/
34
37
  pi-web
35
38
  ```
36
39
 
37
- To update, stop the running process with `Ctrl+C` and run the same install command again. To uninstall, run `npm uninstall -g @agegr/pi-web`.
40
+ Or without a global install:
41
+
42
+ ```bash
43
+ npx @pricening/pi-web@latest --registry=https://registry.npmjs.org/
44
+ ```
45
+
46
+ The CLI opens a browser when the server is ready. If it does not, open [http://127.0.0.1:30141](http://127.0.0.1:30141). By default Pi Web listens only on `127.0.0.1`.
47
+
48
+ If no model provider is configured yet, open the **Models** panel to sign in or add an API key.
49
+
50
+ To update, stop the running process (`Ctrl+C`) and install the same package again. To uninstall: `npm uninstall -g @pricening/pi-web`.
51
+
52
+ Production machines should pin an exact version (`PI_WEB_PIN` on Windows, or a systemd unit that does not run `npm update`). Do not blindly follow `@latest` on every box; see [docs/FORK.md §7](./docs/FORK.md).
38
53
 
39
54
  ## Configuration
40
55
 
41
- For port and hostname, command-line options override the corresponding environment variables. Either `--no-open` or `PI_WEB_NO_OPEN=1` disables automatic browser opening. Run `pi-web --help` (or `-h`) to print startup options and exit without starting the server. Unknown options exit with an error.
56
+ Command-line options override the matching environment variables. `--no-open` or `PI_WEB_NO_OPEN=1` skips opening a browser. `pi-web --help` prints startup options and exits.
42
57
 
43
58
  | Option or environment variable | Purpose | Default |
44
59
  | --- | --- | --- |
@@ -47,104 +62,31 @@ For port and hostname, command-line options override the corresponding environme
47
62
  | `--hostname <host>`, `-H <host>`, or `PI_WEB_HOSTNAME` | Bind hostname | `127.0.0.1` |
48
63
  | `--no-open` or `PI_WEB_NO_OPEN=1` | Do not open a browser automatically | Browser opens |
49
64
  | `PI_WEB_SKIP_VERSION_CHECK=1` | Disable Pi Web update checks | Unset |
50
- | `PI_WEB_ALLOWED_HOSTS` | Additional exact proxy or custom hostnames, comma-separated | Unset |
51
- | `PI_WEB_PASSWORD` | Enable browser password login; API clients may use Basic Auth with username `pi` | Authentication disabled |
52
- | `PI_WEB_IDLE_TIMEOUT_MS` | Session idle timeout in milliseconds, up to `2147483647`; `0` disables idle shutdown; invalid or out-of-range values use the default | `600000` (10 min) |
53
-
54
- For example:
65
+ | `PI_WEB_ALLOWED_HOSTS` | Extra exact proxy/custom hostnames, comma-separated | Unset |
66
+ | `PI_WEB_PASSWORD` | Browser password login; API clients may use Basic Auth as user `pi` | Auth disabled |
67
+ | `PI_WEB_IDLE_TIMEOUT_MS` | Session idle timeout in ms; `0` disables idle shutdown | `600000` (10 min) |
55
68
 
56
69
  ```bash
57
70
  pi-web --help
58
71
  pi-web -p 8080 -H 0.0.0.0 --no-open
59
72
  ```
60
73
 
61
- ### Remote Access
74
+ ### Remote access
62
75
 
63
- Binding to a non-loopback address exposes an agent that can execute high-privilege actions. On a trusted LAN, require a long random password:
76
+ Binding to a non-loopback address exposes an agent that can run high-privilege actions. On a trusted LAN, set a long random password:
64
77
 
65
78
  ```bash
66
79
  PI_WEB_PASSWORD='a-long-random-password' pi-web --hostname 0.0.0.0
67
80
  ```
68
81
 
69
- Password authentication does not encrypt the connection. Do not expose Pi Web over plain HTTP to the internet; use HTTPS through a trusted reverse proxy or a trusted VPN. If a reverse proxy sends an external hostname, add that exact name to `PI_WEB_ALLOWED_HOSTS`. This allow-list does not change the address Pi Web binds to.
70
-
71
- ### HTTP Proxy
72
-
73
- Server-side model and API requests honor the standard `HTTP_PROXY`, `HTTPS_PROXY`, and `NO_PROXY` environment variables.
74
-
75
- On macOS or Linux:
76
-
77
- ```bash
78
- HTTP_PROXY=http://127.0.0.1:7890 \
79
- HTTPS_PROXY=http://127.0.0.1:7890 \
80
- NO_PROXY=localhost,127.0.0.1 \
81
- npx @agegr/pi-web@latest
82
- ```
83
-
84
- On Windows PowerShell:
85
-
86
- ```powershell
87
- $env:HTTP_PROXY = "http://127.0.0.1:7890"
88
- $env:HTTPS_PROXY = "http://127.0.0.1:7890"
89
- $env:NO_PROXY = "localhost,127.0.0.1"
90
- npx @agegr/pi-web@latest
91
- ```
82
+ Password auth does not encrypt the connection. Do not put Pi Web on the public internet over plain HTTP.
92
83
 
93
84
  ## Notes
94
85
 
95
- - **Agent data**: Pi Web reads pi data from `~/.pi/agent` by default, including session files under `sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl`. Set `PI_CODING_AGENT_DIR` to use another pi agent directory.
96
- - **Filesystem access**: Pi Web must be able to read the agent data directory and the working directories recorded by its sessions. Run Pi Web in the same filesystem environment as pi when sharing existing sessions.
97
- - **Shared configuration**: the Models panel uses pi's model, settings, and credential storage, so changes are visible to both interfaces.
98
- - **File access boundary**: the file browser is limited to working directories selected in Pi Web and project or session roots it already knows about; it is not a general filesystem browser.
99
- - **Git worktrees**: see [Worktrees in Pi Web](./docs/worktrees.md) for switcher visibility, worktree creation, and removal behavior.
100
-
101
- ### Downstream Session Context Menu
102
-
103
- Electron wrappers and other downstream integrations can provide a session-row
104
- context menu without patching `SessionSidebar`. Listen for the cancelable
105
- `pi-web:session-row-contextmenu` browser event and call `preventDefault()`
106
- synchronously when the integration will handle it:
107
-
108
- ```js
109
- window.addEventListener("pi-web:session-row-contextmenu", (event) => {
110
- event.preventDefault();
111
- const { id, path, cwd, name, clientX, clientY, refresh } = event.detail;
112
-
113
- void openSessionMenu({ id, path, cwd, name, clientX, clientY }).then((changed) => {
114
- if (changed) refresh();
115
- });
116
- });
117
- ```
118
-
119
- The detail object contains `id`, `path`, `cwd`, optional `name`, pointer
120
- coordinates, and a `refresh()` callback for actions that change the session
121
- list. If no listener cancels the extension event, Pi Web preserves the
122
- browser's native context menu. This hook is browser-side and independent of
123
- Pi agent extensions.
124
-
125
- ### Extension Session Liveness
126
-
127
- Server-side Pi extensions with detached work can prevent automatic idle
128
- session eviction through the versioned global registry:
129
-
130
- ```js
131
- const liveness = globalThis[Symbol.for("@agegr/pi-web/session-liveness/v1")];
132
- const release = liveness?.version === 1
133
- ? liveness.register({
134
- name: "my-extension",
135
- sessionId,
136
- sessionFile: sessionFile || undefined,
137
- isActive: () => detachedJobs.size > 0,
138
- })
139
- : () => {};
140
- ```
141
-
142
- Register once per active extension session and call the returned idempotent
143
- `release` function on session shutdown, replacement, or reload. `isActive`
144
- must be synchronous, cheap, and scoped to the supplied exact session id or
145
- file. Provider errors fail safe by preserving that session. This lease only
146
- affects automatic idle eviction; explicit shutdown and Stop fallback cleanup
147
- still take precedence.
86
+ - **Agent data**: reads `~/.pi/agent` by default (session files under `sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl`). Override with `PI_CODING_AGENT_DIR`.
87
+ - **Shared with local pi**: models, settings, and credentials are pi’s files. This fork only writes extra state under `~/.pi/agent/pi-web/` (`pins.json`, `archives.json`). It does not rewrite `settings.json` / `auth.json` / session jsonl content.
88
+ - **File access** is limited to known project/session roots; it is not a general filesystem browser.
89
+ - **Git worktrees**: [Worktrees in Pi Web](./docs/worktrees.md).
148
90
 
149
91
  ## Development
150
92
 
@@ -153,7 +95,7 @@ npm install
153
95
  npm run dev
154
96
  ```
155
97
 
156
- The development server runs at [http://127.0.0.1:30141](http://127.0.0.1:30141). Run the common checks with:
98
+ Dev server: [http://127.0.0.1:30141](http://127.0.0.1:30141). Checks:
157
99
 
158
100
  ```bash
159
101
  npm test
@@ -161,24 +103,10 @@ node_modules/.bin/tsc --noEmit
161
103
  npm run lint
162
104
  ```
163
105
 
164
- Do not run `next build` or `npm run build` during normal development. It writes to `.next/` and can interfere with the development server; leave builds for release work.
165
-
166
- Contributor guides: [Internationalization](./docs/i18n.md) and [Release process](./docs/release.md).
167
-
168
- ## Repository Layout
169
-
170
- ```text
171
- app/ Next.js UI and API routes
172
- components/ React UI components
173
- hooks/ Client state and interaction hooks
174
- lib/ Session, agent, model, file, Git, and security logic
175
- public/ Static assets and PWA files
176
- bin/ npm CLI entrypoint and launch option parsing
177
- docs/ Focused user and contributor guides
178
- ```
106
+ Do **not** run `next build` / `npm run build` during normal development — it pollutes `.next/` and can break `npm run dev`. Builds belong in CI.
179
107
 
180
- See [AGENTS.md](./AGENTS.md) for the architecture notes and detailed file map.
108
+ Patch discipline, versioning, and upstream sync: [docs/FORK.md](./docs/FORK.md). Architecture map: [AGENTS.md](./AGENTS.md).
181
109
 
182
110
  ## License
183
111
 
184
- [MIT](./LICENSE)
112
+ [MIT](./LICENSE), same as upstream.
package/README.ru.md CHANGED
@@ -1,134 +1,11 @@
1
- # Pi Web
1
+ # @pricening/pi-web
2
2
 
3
- [English](./README.md) | [中文文档](./README.zh-CN.md) | [日本語](./README.ja.md)
3
+ This repository is a **personal fork** of [agegr/pi-web](https://github.com/agegr/pi-web).
4
4
 
5
- Локальный браузерный интерфейс для [pi coding agent](https://github.com/earendil-works/pi). Pi Web использует те же локальные настройки и файлы сессий, что и pi, поэтому в браузере можно находить и продолжать диалоги, запускать агента, настраивать модели и ресурсы, а также просматривать файлы проекта.
5
+ Please read:
6
6
 
7
- ![Pi Web показывает сессию pi со структурированным Markdown, вызовами инструментов и навигацией по проекту](https://raw.githubusercontent.com/agegr/pi-web/main/docs/screenshot2.png)
7
+ - [README.md](./README.md) (English)
8
+ - [README.zh-CN.md](./README.zh-CN.md) (简体中文)
9
+ - Maintenance rules: [docs/FORK.md](./docs/FORK.md)
8
10
 
9
- ## Возможности
10
-
11
- - **Рабочее пространство сессий**: просмотр, продолжение, переименование, экспорт и удаление диалогов, сгруппированных по проектам, с отображением состояния выполнения, использования контекста, стоимости и сведений о сжатии.
12
- - **Два способа создать ветку**: **New session** создаёт независимый файл сессии из более раннего сообщения, а **Edit from here** создаёт ветку внутри текущей сессии.
13
- - **Инструменты для файлов проекта**: просмотр и загрузка файлов, проверка Git Diff, предпросмотр исходного кода, Markdown, изображений, аудио, PDF и DOCX с автоматическим обновлением.
14
- - **Git worktree**: переключение рабочих деревьев в боковой панели с сохранением общей группы сессий одного репозитория.
15
- - **Настройка через Web**: управление входом в Provider и API Key, моделями, тестами моделей, пакетами плагинов и навыками без выхода из Pi Web.
16
- - **Интерфейс на английском, упрощённом и традиционном китайском**: при первом запуске Pi Web учитывает язык браузера, а затем язык можно переключить в верхней панели.
17
-
18
- ## Быстрый старт
19
-
20
- Для работы Pi Web требуется Node.js 22.19.0 или новее. Проверьте версию командой `node --version`, затем выполните:
21
-
22
- ```bash
23
- npx @agegr/pi-web@latest
24
- ```
25
-
26
- Когда сервер будет готов, CLI попытается открыть браузер автоматически. Если этого не произошло, откройте [http://127.0.0.1:30141](http://127.0.0.1:30141). По умолчанию Pi Web прослушивает только `127.0.0.1`.
27
-
28
- Если Provider модели ещё не настроен, откройте панель **Models**, войдите в учётную запись или добавьте API Key.
29
-
30
- Чтобы установить команду `pi-web` глобально:
31
-
32
- ```bash
33
- npm install -g @agegr/pi-web@latest
34
- pi-web
35
- ```
36
-
37
- Для обновления остановите запущенный процесс с помощью `Ctrl+C` и повторите ту же команду установки. Для удаления выполните `npm uninstall -g @agegr/pi-web`.
38
-
39
- ## Настройка
40
-
41
- Для порта и имени хоста параметры командной строки имеют приоритет над соответствующими переменными окружения. И `--no-open`, и `PI_WEB_NO_OPEN=1` отключают автоматическое открытие браузера независимо друг от друга. `pi-web --help` (или `-h`) выводит параметры запуска и завершает работу без старта сервера. Неизвестные параметры завершают процесс с ошибкой.
42
-
43
- | Параметр или переменная окружения | Назначение | Значение по умолчанию |
44
- | --- | --- | --- |
45
- | `--help`, `-h` | Показать параметры запуска и выйти | — |
46
- | `--port <port>`, `-p <port>` или `PORT` | Порт сервера | `30141` |
47
- | `--hostname <host>`, `-H <host>` или `PI_WEB_HOSTNAME` | Имя хоста для привязки | `127.0.0.1` |
48
- | `--no-open` или `PI_WEB_NO_OPEN=1` | Не открывать браузер автоматически | Браузер открывается |
49
- | `PI_WEB_ALLOWED_HOSTS` | Дополнительные точные имена прокси или пользовательских хостов через запятую | Не задано |
50
- | `PI_WEB_PASSWORD` | Включить вход по паролю в браузере; API также поддерживает Basic Auth с именем `pi` | Аутентификация отключена |
51
-
52
- Пример:
53
-
54
- ```bash
55
- pi-web --help
56
- pi-web -p 8080 -H 0.0.0.0 --no-open
57
- ```
58
-
59
- ### Удалённый доступ
60
-
61
- Привязка к адресу, отличному от loopback, открывает сетевой доступ к агенту, способному выполнять операции с широкими полномочиями. Даже в доверенной локальной сети используйте длинный случайный пароль:
62
-
63
- ```bash
64
- PI_WEB_PASSWORD='длинный-случайный-пароль' pi-web --hostname 0.0.0.0
65
- ```
66
-
67
- Парольная аутентификация не шифрует соединение. Не публикуйте Pi Web в интернете по обычному HTTP; используйте HTTPS через доверенный обратный прокси или надёжное VPN-подключение. Если обратный прокси передаёт внешнее имя хоста, добавьте это точное имя в `PI_WEB_ALLOWED_HOSTS`. Этот список разрешённых имён не меняет адрес, к которому привязывается Pi Web.
68
-
69
- ### HTTP-прокси
70
-
71
- Для серверных запросов к моделям и API используются стандартные переменные окружения `HTTP_PROXY`, `HTTPS_PROXY` и `NO_PROXY`.
72
-
73
- В macOS и Linux:
74
-
75
- ```bash
76
- HTTP_PROXY=http://127.0.0.1:7890 \
77
- HTTPS_PROXY=http://127.0.0.1:7890 \
78
- NO_PROXY=localhost,127.0.0.1 \
79
- npx @agegr/pi-web@latest
80
- ```
81
-
82
- В Windows PowerShell:
83
-
84
- ```powershell
85
- $env:HTTP_PROXY = "http://127.0.0.1:7890"
86
- $env:HTTPS_PROXY = "http://127.0.0.1:7890"
87
- $env:NO_PROXY = "localhost,127.0.0.1"
88
- npx @agegr/pi-web@latest
89
- ```
90
-
91
- ## Примечания
92
-
93
- - **Данные агента**: по умолчанию Pi Web читает данные pi из `~/.pi/agent`, включая файлы сессий в `sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl`. Чтобы использовать другой каталог агента pi, задайте `PI_CODING_AGENT_DIR`.
94
- - **Доступ к файловой системе**: Pi Web должен иметь доступ для чтения к каталогу данных агента и рабочим каталогам, записанным в сессиях. При совместном использовании существующих сессий запускайте Pi Web в той же файловой среде, что и pi.
95
- - **Общие настройки**: панель Models использует хранилища моделей, настроек и учётных данных pi, поэтому изменения видны в обоих интерфейсах.
96
- - **Граница доступа к файлам**: файловый браузер ограничен рабочими каталогами, выбранными в Pi Web, и уже известными корнями проектов или сессий; это не универсальный файловый менеджер.
97
- - **Git worktree**: условия отображения переключателя, создание рабочих деревьев и их удаление описаны в документе [Worktrees in Pi Web](./docs/worktrees.md).
98
-
99
- ## Разработка
100
-
101
- ```bash
102
- npm install
103
- npm run dev
104
- ```
105
-
106
- Сервер разработки доступен по адресу [http://127.0.0.1:30141](http://127.0.0.1:30141). Основные проверки запускаются командами:
107
-
108
- ```bash
109
- npm test
110
- node_modules/.bin/tsc --noEmit
111
- npm run lint
112
- ```
113
-
114
- Не запускайте `next build` или `npm run build` во время обычной разработки. Эти команды записывают данные в `.next/` и могут помешать работе сервера разработки; выполняйте сборку только при подготовке релиза.
115
-
116
- Руководства для участников: [Internationalization](./docs/i18n.md) и [Release process](./docs/release.md).
117
-
118
- ## Структура репозитория
119
-
120
- ```text
121
- app/ UI Next.js и маршруты API
122
- components/ Компоненты интерфейса React
123
- hooks/ Состояние клиента и обработчики взаимодействий
124
- lib/ Логика сессий, агента, моделей, файлов, Git и безопасности
125
- public/ Статические ресурсы и файлы PWA
126
- bin/ Точка входа npm CLI и разбор параметров запуска
127
- docs/ Тематические руководства для пользователей и участников
128
- ```
129
-
130
- Описание архитектуры и подробная карта файлов приведены в [AGENTS.md](./AGENTS.md).
131
-
132
- ## Лицензия
133
-
134
- [MIT](./LICENSE)
11
+ npm package: **`@pricening/pi-web`** (not `@agegr/pi-web`).