codex-webapp 0.1.0-beta.1 → 0.1.0-beta.2

package/README.ja.md

@@ -1,43 +1,14 @@
-> **非公式の community project です。** この project は OpenAI、公式 Codex team、または公式 Codex App と提携・承認・後援・関連していません。
-
 # Codex WebApp
 
 [English](./README.md) / 日本語 / [한국어](./docs/i18n/README.ko.md) / [简体中文](./docs/i18n/README.zh-CN.md)
 
-Codex App を使っている人向けの、敬意ある非公式 WebApp surface です。
+Codex App から、Codex 風のブラウザ画面を開くための小さな非公式 npm package です。
 
-Codex App に貼れるプロンプト、わかりやすい `doctor`、安全なローカル起動、そして「本当に Codex っぽいブラウザ画面が開けるか」を確認する smoke test をまとめています。
+Codex の準備確認、ローカルUIの起動、表示確認を、Codex App に貼るだけのプロンプトで進めやすくします。
 
 ![Codex WebApp overview](./docs/assets/codex-webapp-overview.svg)
 
-> OpenAI とは提携しておらず、OpenAI から承認・推奨された公式プロダクトではありません。
->
-> 生の UI サーバーは原則 `localhost` のまま使ってください。スマホや別PCから触る場合は、Tailscale、Cloudflare Access、または同等の信頼できるアクセス境界を先に用意してください。公開IPへ直接出さないでください。
-
-## これは何ですか
-
-「Codex をブラウザやスマホから使えるらしい」と聞いたのに、サーバー起動後に何を開けばいいかわからない。そこを埋めるための npm パッケージです。
-
-この beta でできること:
-
-- Codex CLI が入っているか確認する
-- `codex remote-control --help` が使えるか確認する
-- npm の一時実行で `doctor` / `start` / `smoke` を走らせる
-- Codex App に貼るだけのプロンプトを提供する
-- ローカルの Codex 風ブラウザ UI を起動する
-- smoke test で「画面が本当に見えている」ことを確認する
-
-## いまの beta の位置づけ
-
-現在の npm beta は `codex-webapp@0.1.0-beta.1` です。
-
-これは Codex App の native marketplace plugin、browser extension、one-click installer、managed hosting service ではありません。Codex App にプロンプトを貼り、Codex に `npx` で npm パッケージを実行してもらう形です。
-
-現在の方針は experimental かつ compatibility-first です。現在は `0xcaff/codex-web` の commit `585613f5a3a355af5aefc388ca4e31b07a472cda` を参照する Codex 風 browser runtime を起動し、その周辺に install、safety、evidence、support の層を加えています。この public repository は package、user documentation、safety notes、contribution path に絞ります。
-
-注: 現在、software interface 自体は主に英語です。この日本語ドキュメントは setup を助けるための翻訳です。
-
-## Codex App に貼るプロンプト
+## Codex App に貼る
 
 以下をそのまま Codex App に貼ってください。
 
@@ -51,16 +22,13 @@ Please:
 1. Check my Codex version.
 2. Run the package doctor.
 3. Run start in dry-run mode first.
-4. Start the local browser UI only on localhost.
+4. Start the local browser UI on localhost.
 5. Smoke-test the printed local URL.
 
-Keep everything on localhost unless I already have Tailscale, Cloudflare Access,
-or another trusted access boundary set up.
-
 Do not print tokens, cookies, private repo contents, customer data, or internal URLs.
 ```
 
-Codex は内部でだいたい次のようなコマンドを実行します。
+Codex はだいたい次のコマンドを実行します。
 
 ```bash
 npx -y codex-webapp@beta doctor
@@ -68,76 +36,55 @@ npx -y codex-webapp@beta start --dry-run
 npx -y codex-webapp@beta start
 ```
 
-`npx` は「npm に公開されているパッケージを、一時的に実行するための仕組み」です。ユーザーが手でプロジェクトを作ったり、依存関係を管理したりする必要を減らします。
+`npx` は、npm に公開されている package を一時的に実行する仕組みです。ユーザーが手でプロジェクトを作る必要はありません。
 
-## ターミナルで試す場合
+## ターミナルで使う
 
 ```bash
-codex --version
-codex remote-control --help
 npx -y codex-webapp@beta doctor
 npx -y codex-webapp@beta start --dry-run
 npx -y codex-webapp@beta start
 ```
 
-デフォルトでは次のローカルURLを使います。
+デフォルトURL:
 
 ```text
 http://127.0.0.1:8214/
 ```
 
-## Smoke Test
-
-UI サーバーを起動したら、次で確認できます。
-
-```bash
-npx -y codex-webapp@beta smoke \
-  --url http://127.0.0.1:8214/
-```
-
-ブラウザ証跡を撮る場合:
+表示確認:
 
 ```bash
-npx -y codex-webapp@beta smoke \
-  --browser \
-  --url http://127.0.0.1:8214/ \
-  --screenshot artifacts/codex-webapp.png
+npx -y codex-webapp@beta smoke --url http://127.0.0.1:8214/
 ```
 
-公開する証跡には、private repo、branch名、アカウント情報、顧客データ、token、cookie、社内URLを含めないでください。
-
-## 安全境界
+## 何をするものか
 
-この package は、危険なネットワーク公開を安全に変える魔法ではありません。
-
-推奨:
-
-- 自分のMacだけで使うなら `localhost`
-- 自分の端末間だけなら Tailscale
-- 複数人で使うなら Cloudflare Access などの identity-aware proxy
-
-避けること:
+- Codex CLI が入っているか確認する
+- `codex remote-control --help` が動くか確認する
+- Codex 風のブラウザUIを localhost で起動する
+- UI URL にアクセスできるか smoke test する
+- Codex App から貼るだけで進めやすい導線を用意する
 
-- 生の UI サーバーを public IP に出す
-- token / cookie / customer data / private repo 内容を public issue に貼る
-- OpenAI 公式プロダクトのように見せる
-- 現在の beta を managed hosting service として扱う
+現在の runtime reference:
 
-## Security And Privacy
+```text
+github:0xcaff/codex-web#585613f5a3a355af5aefc388ca4e31b07a472cda
+```
 
-この package は open source で、監査可能であることを前提にしています。
+## 安全メモ
 
-CLI wrapper は、prompt、repository、token、cookie、customer data を、この project が運営する第三者サーバーへ送信しません。ローカルの Codex 風 browser surface を起動し、指定された URL に対して readiness / smoke check を行います。
+Codex WebApp は OpenAI 公式プロダクトではなく、OpenAI から承認・推奨されたものではありません。
 
-この package は browser extension をインストールせず、browser token を `localStorage`、`chrome.storage`、extension profile に保存しません。ただし、下層の Codex 風 runtime や、利用者自身が用意する trusted-access layer には別の挙動があり得ます。運用境界として確認してください。
+生のUIサーバーは `localhost` のまま使ってください。スマホや別PCから使う場合は、Tailscale、Cloudflare Access、または同等の信頼できるアクセス境界を先に用意してください。
 
-public issue や screenshot を共有する前に、secret と private URL は削除してください。
+Codex WebApp は telemetry / analytics / project-operated phone-home path を含みません。browser extension もインストールしません。
 
-## 謝辞
+## Support
 
-現在の beta は、Codex 風ブラウザ体験を実現する public project `0xcaff/codex-web` のアプローチを利用・参照しています。この repository は、その周辺に配布、doctor、安全境界、ドキュメント、検証証跡の層を加えるものです。
+issue には OS、Node version、Codex version、実行した command、redact済みの `doctor` / `start` / `smoke` output を入れてください。
 
-詳しくは [ACKNOWLEDGEMENTS.md](./ACKNOWLEDGEMENTS.md) を参照してください。
+token、cookie、private repo、customer data、internal URL は public issue に貼らないでください。
 
 ## License
 

package/README.md

@@ -1,7 +1,3 @@
-> **Unofficial community project.** This project is not affiliated with,
-> sponsored by, endorsed by, or associated with OpenAI, the official Codex team,
-> or the official Codex App.
-
 # Codex WebApp
 
 [![CI](https://github.com/penso-os/codex-webapp/actions/workflows/ci.yml/badge.svg)](https://github.com/penso-os/codex-webapp/actions/workflows/ci.yml)
@@ -9,62 +5,15 @@
 [![npm beta](https://img.shields.io/npm/v/codex-webapp/beta?label=beta)](https://www.npmjs.com/package/codex-webapp)
 [![License](https://img.shields.io/npm/l/codex-webapp)](./LICENSE.md)
 
-A respectful, community-maintained web app surface for Codex App users.
+Open a Codex-style browser UI from Codex App.
 
-It gives you a pasteable Codex App prompt, a friendly `doctor`, a safe local
-launcher, and smoke tests that prove a real Codex-style browser surface is
-reachable from a machine you control.
+Codex WebApp is a small, unofficial npm package that helps Codex App check your
+local Codex install, start the browser surface, and verify that something useful
+actually opened.
 
 ![Codex WebApp overview](./docs/assets/codex-webapp-overview.svg)
 
-> Not affiliated with or endorsed by OpenAI.
->
-> Keep the raw UI server on `localhost` unless you have Tailscale, Cloudflare
-> Access, or an equivalent trusted access boundary. Do not put the raw server on
-> a public IP.
-
-Quick check:
-
-```bash
-npx -y codex-webapp@beta doctor
-```
-
-## Languages
-
-- English: this README
-- Japanese: [README.ja.md](./README.ja.md)
-- Korean: [docs/i18n/README.ko.md](./docs/i18n/README.ko.md)
-- Simplified Chinese: [docs/i18n/README.zh-CN.md](./docs/i18n/README.zh-CN.md)
-
-## Who This Is For
-
-This package is for people who opened Codex App, heard that Codex can be used
-from a browser or phone, and then got stuck at "the server is running, but what
-do I open?"
-
-It is also for maintainers who want a repeatable public-beta gate:
-
-- check the local Codex install
-- start the Codex-style browser UI on a safe local port
-- verify the page with HTTP or browser smoke tests
-- collect evidence before sharing a beta package
-- document the trusted-access boundary instead of improvising it in DMs
-
-## Current Beta Shape
-
-Current npm beta: `codex-webapp@0.1.0-beta.1`
-
-This is an npm package that Codex App can run through a prompt. It is not a
-native Codex App marketplace plugin, browser extension, one-click installer, or
-managed hosting service.
-
-The current beta is experimental and compatibility-first. It launches a pinned
-Codex-style web runtime reference, currently `0xcaff/codex-web` at commit
-`585613f5a3a355af5aefc388ca4e31b07a472cda`, and wraps it with clearer install,
-safety, evidence, and support behavior. The public repository is kept focused on
-the package, user documentation, safety notes, and contribution path.
-
-## Codex App Quick Start
+## Start From Codex App
 
 Paste this into Codex App:
 
@@ -78,16 +27,13 @@ Please:
 1. Check my Codex version.
 2. Run the package doctor.
 3. Run start in dry-run mode first.
-4. Start the local browser UI only on localhost.
+4. Start the local browser UI on localhost.
 5. Smoke-test the printed local URL.
 
-Keep everything on localhost unless I already have Tailscale, Cloudflare Access,
-or another trusted access boundary set up.
-
 Do not print tokens, cookies, private repo contents, customer data, or internal URLs.
 ```
 
-Codex should run commands like these for you:
+Codex should run commands like:
 
 ```bash
 npx -y codex-webapp@beta doctor
@@ -95,49 +41,30 @@ npx -y codex-webapp@beta start --dry-run
 npx -y codex-webapp@beta start
 ```
 
-If Codex App asks what `npx` means, the plain-English answer is:
-
-> `npx` runs a published npm package temporarily, without asking you to install
-> or manage a project by hand.
+`npx` means Codex runs the published package temporarily. You do not need to
+create a project or install this package by hand.
 
-## Terminal Quick Start
-
-Developers can run the same flow from a terminal:
+## Use From A Terminal
 
 ```bash
-# 1. Confirm Codex is available.
-codex --version
-
-# 2. Check whether the remote-control command exists.
-codex remote-control --help
-
-# 3. Run the friendly readiness check.
 npx -y codex-webapp@beta doctor
-
-# 4. Preview the launcher command without starting anything.
 npx -y codex-webapp@beta start --dry-run
-
-# 5. Start the local Codex-style browser UI.
 npx -y codex-webapp@beta start
 ```
 
-By default the browser UI is local only:
+By default the local UI opens at:
 
 ```text
 http://127.0.0.1:8214/
 ```
 
-## Browser Smoke Test
-
-Once the UI server is running:
+Check the browser surface:
 
 ```bash
-npx -y codex-webapp@beta smoke \
-  --url http://127.0.0.1:8214/
+npx -y codex-webapp@beta smoke --url http://127.0.0.1:8214/
 ```
 
-The lightweight smoke test fetches the page and checks for the expected
-Codex-style surface. To capture browser evidence:
+Capture browser evidence when needed:
 
 ```bash
 npx -y codex-webapp@beta smoke \
@@ -146,85 +73,39 @@ npx -y codex-webapp@beta smoke \
   --screenshot artifacts/codex-webapp.png
 ```
 
-If Playwright is missing:
-
-```bash
-npm install -D playwright
-npx playwright install chromium
-```
-
-Public evidence must use a clean or demo environment. Do not publish screenshots
-that expose private repositories, private branches, account metadata, customer
-data, tokens, cookies, or internal URLs.
-
-## Safety Boundary
-
-This package does not make an unsafe network setup safe.
+## What It Does
 
-Use one of these boundaries:
+- checks that Codex CLI is installed
+- checks that `codex remote-control --help` works
+- starts a pinned Codex-style browser surface on localhost
+- refuses non-loopback hosts unless explicitly allowed
+- smoke-tests that the UI URL is reachable
+- keeps the install path simple enough to paste into Codex App
 
-- `localhost` only for local use
-- Tailscale for private-device access
-- Cloudflare Access or an equivalent identity-aware proxy for shared access
+Current runtime reference:
 
-Do not:
-
-- expose a raw Codex UI server on a public IP
-- paste tokens, cookies, customer data, or private repository contents into
-  public issues
-- describe this project as an official OpenAI or Codex product
-- treat the current beta as a managed hosting service
-
-## Security And Privacy
+```text
+github:0xcaff/codex-web#585613f5a3a355af5aefc388ca4e31b07a472cda
+```
 
-This package is open source and intended to be auditable.
+## Safety Notes
 
-The CLI wrapper does not send your prompts, repositories, tokens, cookies, or
-customer data to a third-party service operated by this project. It launches a
-local Codex-style browser surface and runs local readiness/smoke checks against
-the URL you provide.
+Codex WebApp is not affiliated with or endorsed by OpenAI.
 
-This package does not install a browser extension and does not write browser
-tokens to `localStorage`, `chrome.storage`, or an extension profile. The
-underlying Codex-style runtime and your own trusted-access layer may have their
-own behavior; review and operate those components as part of your deployment
-boundary.
+Keep the raw UI server on `localhost` unless you have Tailscale, Cloudflare
+Access, or an equivalent trusted access boundary. Do not expose it directly on a
+public IP.
 
 Codex WebApp does not include telemetry, analytics, or a project-operated
-phone-home path.
-
-For public support, remove secrets and private URLs before sharing command
-output or screenshots.
-
-## Product Principles
-
-![Mobile and trusted-access concept](./docs/assets/codex-webapp-mobile.svg)
+phone-home path. It does not install a browser extension and does not store
+browser tokens in extension storage.
 
-- **Codex App first**: the primary path is a prompt a non-CLI user can paste
-  into Codex App.
-- **Compatibility first**: staying close to the Codex browser experience is more
-  valuable than a custom UI that drifts quickly.
-- **Security owned**: the public package must keep the raw server local and make
-  trusted access explicit.
-- **Evidence driven**: launch claims must be backed by doctor, dry-run, smoke,
-  browser, and clean-sandbox evidence.
-- **Contribution friendly**: the repo should be easy to inspect, test, and
-  improve without needing private maintainer context.
-
-## Repository Layout
+## Languages
 
-```text
-bin/codex-webapp.mjs      CLI entrypoint for doctor/start/smoke
-src/commands.js           CLI command handlers
-src/browserSmoke.js       HTTP and optional Playwright smoke checks
-src/codexWeb.js           Codex-style web launch arguments and safety checks
-src/version.js            Codex CLI version parsing and readiness checks
-test/*.test.mjs           node:test coverage
-docs/assets/              public-safe README visuals
-docs/i18n/                localized quickstart docs
-docs/codex-app-install.md Codex App prompt-driven setup guide
-docs/ja-quickstart.md     Japanese quickstart guide
-```
+- English: this README
+- Japanese: [README.ja.md](./README.ja.md)
+- Korean: [docs/i18n/README.ko.md](./docs/i18n/README.ko.md)
+- Simplified Chinese: [docs/i18n/README.zh-CN.md](./docs/i18n/README.zh-CN.md)
 
 ## Development
 
@@ -236,35 +117,14 @@ npm run start:dry-run
 
 ## Support
 
-Open a GitHub issue with:
-
-- your OS
-- Node version
-- Codex version
-- the exact command you ran
-- the doctor or smoke output after removing secrets and private URLs
-
-Never paste tokens, cookies, private repository contents, customer data, or
-internal URLs into a public issue. See [SECURITY.md](./SECURITY.md) and
-[SUPPORT.md](./SUPPORT.md).
-
-## Project Boundary
-
-This repository is the public distribution layer for the browser companion:
-launcher, doctor, smoke tests, documentation, safety boundary, and release
-evidence.
-
-Managed hosting, private support operations, proprietary gateways, and internal
-workspace automation are outside this public package.
-
-## Acknowledgements
+Open an issue with your OS, Node version, Codex version, the command you ran,
+and redacted output from `doctor`, `start`, or `smoke`.
 
-The current beta uses and acknowledges the public `0xcaff/codex-web` approach
-for rendering a Codex-like browser surface. This project adds distribution,
-doctor, safety, documentation, and release-evidence layers around that style of
-workflow while keeping the non-affiliation boundary explicit.
+Do not paste tokens, cookies, private repository contents, customer data, or
+internal URLs into a public issue.
 
-See [ACKNOWLEDGEMENTS.md](./ACKNOWLEDGEMENTS.md).
+See [SECURITY.md](./SECURITY.md), [SUPPORT.md](./SUPPORT.md), and
+[ACKNOWLEDGEMENTS.md](./ACKNOWLEDGEMENTS.md).
 
 ## License
 

package/package.json

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