codex-webapp 0.1.4 → 0.1.6

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.
package/README.ja.md CHANGED
@@ -10,7 +10,7 @@
10
10
 
11
11
  Codex `0.130.0` では、ヘッドレスでリモート制御可能な app-server を起動しやすくする入口として `codex remote-control` が追加されました。[^1] これは大きな前進ですが、そのリリースだけで誰でもすぐに使えるブラウザUIやスマホ向け体験が同梱されたわけではありません。Codex WebApp はその間を埋めるために、ローカルの Codex を確認し、`localhost` 上で Codex 風のWeb画面を起動し、最後に本当に開けたかを smoke test します。
12
12
 
13
- ![Codex WebApp overview](./docs/assets/codex-webapp-overview.svg)
13
+ ![Codex WebApp flow](./docs/assets/codex-webapp-readme.png)
14
14
 
15
15
  ## なぜ作ったか
16
16
 
@@ -66,16 +66,20 @@ npx -y codex-webapp@latest start
66
66
 
67
67
  Codex WebApp はクラウド上に常駐するサービスではありません。あなたのPC上で `npx -y codex-webapp@latest start` が動いている間だけ、ブラウザUIが使えます。
68
68
 
69
+ 大事なポイントは、**PCを再起動すると、このプロセスは自動では戻らない**ということです。昨日使えていても、今日PCを再起動した後は、もう一度 `npx -y codex-webapp@latest start` を実行する必要があります。
70
+
69
71
  | できごと | 何が起きるか | どうすればよいか |
70
72
  | --- | --- | --- |
71
73
  | terminal window を閉じた | Web画面は止まります。 | もう一度 `npx -y codex-webapp@latest start` を実行します。 |
72
74
  | 起動中のUIを止めたい | terminal上のプロセスを止めます。 | 起動しているterminalで `Ctrl+C` を押してください。 |
73
75
  | PCをスリープした | 復帰後に動く場合もありますが、接続が切れることがあります。 | 開けない場合は起動し直してください。 |
74
- | PCを再起動した | プロセスは残りません。 | 再起動後にもう一度 `start` してください。 |
76
+ | PCを再起動した | プロセスは残りません。昨日のWeb画面はもう動いていません。 | 再起動後にもう一度 `npx -y codex-webapp@latest start` を実行してください。 |
75
77
  | 別のPCやスマホから開きたい | `127.0.0.1` は「このPC自身」を指すため、そのままでは別端末から開けません。 | Tailscale、Cloudflare Access、または同等の安全なアクセス境界を用意してください。 |
76
78
 
77
79
  まずは同じPCのブラウザで `http://127.0.0.1:8214/` を開けるところまでを確認してください。スマホや外出先PCからの利用は、その次の段階です。認証なしのport-forwardingやpublic tunnelでraw UI serverを公開すると、意図しない第三者にあなたのPC上のCodex操作面を見せる危険があります。
78
80
 
81
+ 毎日使う場合は、PC起動時に自動で `npx -y codex-webapp@latest start` を実行する設定を検討できます。これは「PCを再起動しても、毎回自分でstartし直さなくてよい」ようにするための設定です。ただし、初回セットアップではなく常用者向けです。まず手動起動で `doctor`、`start`、ブラウザ表示、止め方、アクセス境界を確認してから、macOS の Login Items、`launchd`、または自分が管理できるプロセスマネージャーで設定してください。自動起動する場合も、raw UI server を認証なしで外へ出さないでください。
82
+
79
83
  ## ターミナルから始める
80
84
 
81
85
  自分でコマンドを実行したい場合は、次の順番で進めてください。Codex WebApp には **Node.js 20 以上** と **Codex CLI 0.130.0 以上** が必要です。
@@ -146,7 +150,7 @@ Codex WebApp は telemetry、analytics、browser extension、project-operated ph
146
150
  | Codex CLI | `codex remote-control` を使うため、`0.130.0` 以上が必要です。 |
147
151
  | Node.js | `20` 以上が必要です。 |
148
152
  | network binding | デフォルトは `127.0.0.1`。非 loopback host は明示的な opt-in が必要です。 |
149
- | package channel | npm の `latest` channel から `codex-webapp` を使ってください。現在の release は `0.1.4` です。 |
153
+ | package channel | npm の `latest` channel から `codex-webapp` を使ってください。現在の release は `0.1.6` です。 |
150
154
 
151
155
  Codex が入っていない、または古い場合は、先に更新してください。
152
156
 
package/README.md CHANGED
@@ -10,7 +10,7 @@
10
10
 
11
11
  Codex `0.130.0` added `codex remote-control` as a simpler entrypoint for starting a headless, remotely controllable app-server.[^1] That is an important foundation, but the CLI release does not by itself give every user a ready-to-use browser or phone-friendly experience. Codex WebApp fills that gap by checking your local Codex installation, starting a pinned browser surface on `localhost`, and verifying that the page actually opened.
12
12
 
13
- ![Codex WebApp overview](./docs/assets/codex-webapp-overview.svg)
13
+ ![Codex WebApp flow](./docs/assets/codex-webapp-readme.png)
14
14
 
15
15
  ## Why this exists
16
16
 
@@ -61,15 +61,19 @@ npx -y codex-webapp start
61
61
 
62
62
  Codex WebApp is not a hosted cloud service. The browser UI is available only while `npx -y codex-webapp start` is running on your computer.
63
63
 
64
+ The important point: **after your computer restarts, that process does not come back automatically.** Even if the browser UI worked yesterday, you need to run `npx -y codex-webapp start` again after a reboot unless you have deliberately configured auto-start.
65
+
64
66
  | Event | What happens | What to do |
65
67
  | --- | --- | --- |
66
68
  | You close the terminal window | The browser UI stops. | Run `npx -y codex-webapp start` again. |
67
69
  | The computer sleeps | The connection may survive, but it can also break. | Restart the command if the page no longer opens. |
68
- | The computer restarts | The process is gone. | Run `start` again after rebooting. |
70
+ | The computer restarts | The process is gone. Yesterday’s browser UI is no longer running. | Run `npx -y codex-webapp start` again after rebooting. |
69
71
  | You want to open it from a phone or another PC | `127.0.0.1` means “this same computer,” so another device cannot use that URL directly. | Put Tailscale, Cloudflare Access, or an equivalent trusted access boundary in front first. |
70
72
 
71
73
  Start with the same computer first: run the command, then open `http://127.0.0.1:8214/` in that computer’s browser. Phone and remote access should come after that local check passes.
72
74
 
75
+ If you use this every day, you may eventually want an auto-start setup that runs `npx -y codex-webapp start` when the computer starts. Treat that as an advanced, after-the-first-success step. First confirm manual `doctor`, `start`, browser access, how to stop the process, and your trusted access boundary. If you do configure auto-start through Login Items, `launchd`, or a process manager you control, still do not expose the raw UI server without authentication.
76
+
73
77
  ## Quick start from a terminal
74
78
 
75
79
  Use this route if you prefer to control the commands yourself. Codex WebApp requires **Node.js 20 or newer** and **Codex CLI 0.130.0 or newer**.
@@ -140,7 +144,7 @@ Codex WebApp does not include telemetry, analytics, a browser extension, or a pr
140
144
  | Codex CLI | `0.130.0` or newer, because `codex remote-control` is required. |
141
145
  | Node.js | `20` or newer. |
142
146
  | Network binding | `127.0.0.1` by default. Non-loopback hosts require explicit opt-in. |
143
- | Package channel | `codex-webapp` from the npm `latest` channel. Current release: `0.1.4`. |
147
+ | Package channel | `codex-webapp` from the npm `latest` channel. Current release: `0.1.6`. |
144
148
 
145
149
  If Codex is missing or too old, update it first.
146
150
 
@@ -80,7 +80,7 @@ npx -y codex-webapp smoke \
80
80
 
81
81
  이 패키지는 Codex App native marketplace plugin, browser extension, one-click installer, managed hosting service가 아닙니다. Codex App에 프롬프트를 붙여 넣고, Codex가 `npx`로 npm 패키지를 실행하는 방식입니다.
82
82
 
83
- 현재 release는 `0.1.4`이며 early, compatibility-first입니다. 현재 `0xcaff/codex-web` commit `585613f5a3a355af5aefc388ca4e31b07a472cda`를 참조하는 Codex 스타일 browser runtime을 실행하고, 그 주변에 설치, 안전, 문서, 검증 evidence 계층을 더합니다.
83
+ 현재 release는 `0.1.6`이며 early, compatibility-first입니다. 현재 `0xcaff/codex-web` commit `585613f5a3a355af5aefc388ca4e31b07a472cda`를 참조하는 Codex 스타일 browser runtime을 실행하고, 그 주변에 설치, 안전, 문서, 검증 evidence 계층을 더합니다.
84
84
 
85
85
  ## Security And Privacy
86
86
 
@@ -80,7 +80,7 @@ npx -y codex-webapp smoke \
80
80
 
81
81
  这不是 Codex App native marketplace plugin、browser extension、one-click installer 或 managed hosting service。它的使用方式是:把提示词粘贴到 Codex App,让 Codex 通过 `npx` 执行 npm 包。
82
82
 
83
- 当前 release 为 `0.1.4`,仍处于 early 阶段,并采用 compatibility-first 方针。它目前运行一个引用 `0xcaff/codex-web` commit `585613f5a3a355af5aefc388ca4e31b07a472cda` 的 Codex 风格 browser runtime,并在其周围增加安装、安全、文档和验证证据层。
83
+ 当前 release 为 `0.1.6`,仍处于 early 阶段,并采用 compatibility-first 方针。它目前运行一个引用 `0xcaff/codex-web` commit `585613f5a3a355af5aefc388ca4e31b07a472cda` 的 Codex 风格 browser runtime,并在其周围增加安装、安全、文档和验证证据层。
84
84
 
85
85
  ## Security And Privacy
86
86
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "codex-webapp",
3
- "version": "0.1.4",
3
+ "version": "0.1.6",
4
4
  "description": "Unofficial. Respectful web app surface, doctor, and safety wrapper for Codex App users.",
5
5
  "type": "module",
6
6
  "license": "Apache-2.0",