CLI — web

The unotest-web CLI. Run any command with npx @unotest/web <command> — works with npm, pnpm, yarn or bun.

init

Bootstrap the unotest/ layout, config, and MCP wiring for your editor. Re-run anytime — it never overwrites your edits.

npx @unotest/web init [target] [--browser system|bundled|none]

• --browser — Skip the interactive browser prompt: use system Chrome/Edge, bundled Chromium, or none.

Example

npx @unotest/web init --browser system

e2e

Run a single scenario. name resolves to unotest/e2e/<name>.js.

npx @unotest/web e2e <name> [--debug] [--break line:col]

• --debug — Pause on breakpoints (.debugger.json) and on failure.
• --break line:col[,line:col] — Override breakpoints (comma-separated, no spaces).

Example

npx @unotest/web e2e auth/login --debug

collection

Run a collection (a named set of scenarios), e.g. smoke or regress.

npx @unotest/web collection <name> [--workers=N] [--bail] [--headed]

• --workers=N — Run N scenarios in parallel (default: serial).
• --bail — Stop after the first failure.
• --headed — Run with a visible browser.

Example

npx @unotest/web collection smoke --workers=4

viewer

Open the local IDE-style viewer (HTTP + WebSocket). No cloud, no account.

npx @unotest/web viewer

• UNOTEST_VIEWER_NO_OPEN=1 — Env: start the server without auto-opening a browser.

Example

npx @unotest/web viewer

lint

Static-check scenarios and helpers. Exits non-zero on errors.

npx @unotest/web lint [paths...]

Example

npx @unotest/web lint

install-chromium

Download Playwright’s bundled Chromium (~150 MB). Not needed if you chose system Chrome/Edge.

npx @unotest/web install-chromium

mcp

Run as an MCP stdio server. This is what your editor launches automatically; you rarely run it by hand.

npx @unotest/web mcp