codex-webapp 0.1.2 → 0.1.3

package/README.ja.md

@@ -127,7 +127,7 @@ Codex WebApp は telemetry、analytics、browser extension、project-operated ph
 | Codex CLI | `codex remote-control` を使うため、`0.130.0` 以上が必要です。 |
 | Node.js | `20` 以上が必要です。 |
 | network binding | デフォルトは `127.0.0.1`。非 loopback host は明示的な opt-in が必要です。 |
-| package channel | npm の `latest` channel から `codex-webapp` を使ってください。現在の release は `0.1.2` です。 |
+| package channel | npm の `latest` channel から `codex-webapp` を使ってください。現在の release は `0.1.3` です。 |
 
 Codex が入っていない、または古い場合は、先に更新してください。
 

package/README.md

@@ -127,7 +127,7 @@ Codex WebApp does not include telemetry, analytics, a browser extension, or a pr
 | Codex CLI | `0.130.0` or newer, because `codex remote-control` is required. |
 | Node.js | `20` or newer. |
 | Network binding | `127.0.0.1` by default. Non-loopback hosts require explicit opt-in. |
-| Package channel | `codex-webapp` from the npm `latest` channel. Current release: `0.1.2`. |
+| Package channel | `codex-webapp` from the npm `latest` channel. Current release: `0.1.3`. |
 
 If Codex is missing or too old, update it first.
 

package/docs/codex-app-install.md

@@ -28,9 +28,9 @@ Constraints:
 Steps:
 1. Check whether Codex is available and whether `codex remote-control --help` works.
 2. If Codex is older than 0.130.0, explain the update that is needed.
-3. Run `npx codex-webapp doctor`.
-4. Run `npx codex-webapp start --dry-run`.
-5. If a UI server is available, run `npx codex-webapp smoke --url http://127.0.0.1:8214/`.
+3. Run `npx -y codex-webapp doctor`.
+4. Run `npx -y codex-webapp start --dry-run`.
+5. If a UI server is available, run `npx -y codex-webapp smoke --url http://127.0.0.1:8214/`.
 6. Use `--browser --screenshot artifacts/codex-webapp.png` only when browser evidence is needed.
 7. Summarize pass/fail status and start a small diagnosis if a step fails.
 ```

package/docs/i18n/README.ko.md

@@ -80,7 +80,7 @@ npx -y codex-webapp smoke \
 
 이 패키지는 Codex App native marketplace plugin, browser extension, one-click installer, managed hosting service가 아닙니다. Codex App에 프롬프트를 붙여 넣고, Codex가 `npx`로 npm 패키지를 실행하는 방식입니다.
 
-현재 release는 `0.1.2`이며 early, compatibility-first입니다. 현재 `0xcaff/codex-web` commit `585613f5a3a355af5aefc388ca4e31b07a472cda`를 참조하는 Codex 스타일 browser runtime을 실행하고, 그 주변에 설치, 안전, 문서, 검증 evidence 계층을 더합니다.
+현재 release는 `0.1.3`이며 early, compatibility-first입니다. 현재 `0xcaff/codex-web` commit `585613f5a3a355af5aefc388ca4e31b07a472cda`를 참조하는 Codex 스타일 browser runtime을 실행하고, 그 주변에 설치, 안전, 문서, 검증 evidence 계층을 더합니다.
 
 ## Security And Privacy
 

package/docs/i18n/README.zh-CN.md

@@ -80,7 +80,7 @@ npx -y codex-webapp smoke \
 
 这不是 Codex App native marketplace plugin、browser extension、one-click installer 或 managed hosting service。它的使用方式是：把提示词粘贴到 Codex App，让 Codex 通过 `npx` 执行 npm 包。
 
-当前 release 为 `0.1.2`，仍处于 early 阶段，并采用 compatibility-first 方针。它目前运行一个引用 `0xcaff/codex-web` commit `585613f5a3a355af5aefc388ca4e31b07a472cda` 的 Codex 风格 browser runtime，并在其周围增加安装、安全、文档和验证证据层。
+当前 release 为 `0.1.3`，仍处于 early 阶段，并采用 compatibility-first 方针。它目前运行一个引用 `0xcaff/codex-web` commit `585613f5a3a355af5aefc388ca4e31b07a472cda` 的 Codex 风格 browser runtime，并在其周围增加安装、安全、文档和验证证据层。
 
 ## Security And Privacy
 

package/docs/ja-quickstart.md

@@ -24,7 +24,7 @@ codex remote-control --help
 ## 3. friendly doctor を実行
 
 ```bash
-npx codex-webapp doctor
+npx -y codex-webapp doctor
 ```
 
 Codexが古い、または `remote-control` が見つからない場合は、次に打つべきコマンドを表示します。
@@ -32,13 +32,13 @@ Codexが古い、または `remote-control` が見つからない場合は、次
 ## 4. Codex-style Web UI を起動
 
 ```bash
-npx codex-webapp start
+npx -y codex-webapp start
 ```
 
 このコマンドは起動前に確認プロンプトを出します。自動化された信頼済み環境だけで `--yes` を使ってください。
 
 ```bash
-npx codex-webapp start --yes
+npx -y codex-webapp start --yes
 ```
 
 ## 5. ブラウザで表示できるか確認
@@ -46,7 +46,7 @@ npx codex-webapp start --yes
 UIサーバーが起動している状態で、実ブラウザ疎通を確認します。
 
 ```bash
-npx codex-webapp smoke \
+npx -y codex-webapp smoke \
   --url http://127.0.0.1:8214/
 ```
 
@@ -55,7 +55,7 @@ npx codex-webapp smoke \
 スクリーンショットも残したい場合は、Playwrightを使うdeep smokeを実行します。
 
 ```bash
-npx codex-webapp smoke \
+npx -y codex-webapp smoke \
   --browser \
   --url http://127.0.0.1:8214/ \
   --screenshot artifacts/codex-webapp.png

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codex-webapp",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Unofficial. Respectful web app surface, doctor, and safety wrapper for Codex App users.",
   "type": "module",
   "license": "Apache-2.0",

package/src/commands.js

@@ -1,4 +1,5 @@
 import { spawn, spawnSync } from "node:child_process";
+import { createServer } from "node:net";
 import { createInterface } from "node:readline/promises";
 import { stdin as input, stdout as output } from "node:process";
 
@@ -17,6 +18,17 @@ import {
 } from "./codexWeb.js";
 
 const BANNER = "Codex WebApp — unofficial OpenAI Codex companion; not endorsed by OpenAI.";
+const DEFAULT_WEB_URL = "http://127.0.0.1:8214/";
+
+function codexAppFlowLines(url = DEFAULT_WEB_URL) {
+  return [
+    "Codex App flow:",
+    "  1. Paste a setup request into the Codex App prompt.",
+    "  2. Codex runs: npx -y codex-webapp start",
+    `  3. When it starts, open: ${url}`,
+    "  4. Keep this terminal window open. Closing it will stop the browser UI.",
+  ];
+}
 
 export function main(argv = process.argv) {
   const command = argv[2] ?? "help";
@@ -97,7 +109,9 @@ export function doctor() {
     "`codex remote-control` is available.",
     `codex-web reference: ${CODEX_WEB_REFERENCE}`,
     "Next:",
-    "  npx codex-webapp start",
+    "  npx -y codex-webapp start",
+    "",
+    ...codexAppFlowLines(),
   ]);
 }
 
@@ -126,12 +140,17 @@ export async function start(args = []) {
       BANNER,
       "Dry run passed.",
       `Would start codex-web: ${plannedWebUrl}`,
+      "",
+      ...codexAppFlowLines(plannedWebUrl),
+      "",
       "Would start:",
       `  npx ${npxArgs.join(" ")}`,
     ]);
     return;
   }
 
+  await assertPortAvailable(options.host, options.port);
+
   if (!options.yes) {
     console.log(BANNER);
     console.log(`About to start codex-web: ${plannedWebUrl}`);
@@ -148,6 +167,9 @@ export async function start(args = []) {
 
   console.log(`Starting codex-web from ${CODEX_WEB_REFERENCE}...`);
   console.log(`Open: ${plannedWebUrl}`);
+  console.log("");
+  for (const line of codexAppFlowLines(plannedWebUrl)) console.log(line);
+  console.log("");
   console.log("Keep this terminal open. Expose it only through a trusted local, Tailscale, Cloudflare Access, or equivalent boundary.");
   const codexPath = resolveCodexPath();
   const child = spawn("npx", npxArgs, {
@@ -162,6 +184,23 @@ export async function start(args = []) {
   });
 }
 
+async function assertPortAvailable(host, port) {
+  await new Promise((resolve, reject) => {
+    const server = createServer();
+    server.once("error", (error) => {
+      if (error?.code === "EADDRINUSE") {
+        reject(new Error(`Port ${port} is already in use on ${host}. Codex WebApp may already be running. Close the other terminal window, or start with --port <port>.`));
+        return;
+      }
+      reject(error);
+    });
+    server.once("listening", () => {
+      server.close(resolve);
+    });
+    server.listen(port, host);
+  });
+}
+
 export function help() {
   console.log(`${BANNER}
 
@@ -176,8 +215,16 @@ Commands:
   codex-webapp smoke --url http://127.0.0.1:8214/
   codex-webapp smoke --browser --screenshot artifacts/codex-webapp.png
 
-Quick start:
-  npx codex-webapp doctor
+Quick start from Codex App:
+  Paste a request that asks Codex to run:
+    npx -y codex-webapp doctor
+    npx -y codex-webapp start
+  Then open:
+    ${DEFAULT_WEB_URL}
+
+Terminal quick start:
+  npx -y codex-webapp doctor
+  npx -y codex-webapp start
 `);
 }