name	start-codex-frontend
description	Use this skill when the user asks to start, open, launch, run, or check the Codex frontend, Codex Web UI, Codex browser UI, or says "前端", "启动前端", "打开前端", "Codex 前端", "Web 前端". It starts or reuses the local codexUI/codexapp service for using Codex in a browser.

Start Codex Frontend

Run the bundled script from this skill directory:

bash scripts/start.sh

The script:

reuses the last healthy service started by this script
otherwise chooses an available local port automatically
if CODEX_FRONTEND_PORT is set but unavailable, falls back to another available local port
checks for a local Codex frontend project checkout
clones the frontend project from GitHub if the checkout is missing
installs dependencies and builds the local project if build outputs are missing
starts the local build with node dist-cli/index.js --no-tunnel --no-login
falls back to npx codexapp --no-tunnel --no-login only when local project mode is disabled
clears local proxy environment variables for the launched process by default
writes logs to /tmp/codex-frontend.log
writes the background PID to /tmp/codex-frontend.pid
writes the selected host, port, URL, PID, and project path to /tmp/codex-frontend.env
validates the port and startup timeout before launching
reports a clear next command when a blocker is detected

Port: selected automatically
URL: printed after startup
Bind host used for port probing: 0.0.0.0
Package: codexapp
Frontend repo: https://github.com/friuns2/codexui.git
Frontend project directory: ${XDG_DATA_HOME:-$HOME/.local/share}/codex-frontend/codexui
Package manager: auto-detected, preferring pnpm
Public tunnel: disabled
Forced login: disabled
Local proxy variables: cleared for the launched process

To prefer a specific port:

CODEX_FRONTEND_PORT=19000 bash scripts/start.sh

If that port is unavailable, the script prints the alternate URL it selected.

To use a different local project checkout:

CODEX_FRONTEND_PROJECT_DIR=/path/to/codexui bash scripts/start.sh

To download through a Git proxy:

CODEX_FRONTEND_GIT_PROXY=http://127.0.0.1:7890 bash scripts/start.sh

To skip the local project checkout and use the published npm package:

CODEX_FRONTEND_USE_LOCAL_PROJECT=0 bash scripts/start.sh

To skip install or build steps when managing the checkout yourself:

CODEX_FRONTEND_INSTALL_DEPS=0 CODEX_FRONTEND_BUILD_PROJECT=0 bash scripts/start.sh

If you need to run it without clearing proxy variables:

CODEX_FRONTEND_CLEAR_PROXY=0 bash scripts/start.sh

After running the script, tell the user:

If the script reports a blocker, summarize the exact blocker and the next command to run.

name	start-codex-frontend
description	Use this skill when the user asks to start, open, launch, run, or check the Codex frontend, Codex Web UI, Codex browser UI, or says "前端", "启动前端", "打开前端", "Codex 前端", "Web 前端". It starts or reuses the local codexUI/codexapp service for using Codex in a browser.