Hosted CLI

Run Zerocheck from your terminal.

Install the CLI, authenticate with Zerocheck, and run approved tests or generate suggestions through Zerocheck's hosted browser runner.

Run once
npx zerocheck@latest login && npx zerocheck@latest run --url https://staging.yourapp.com

Node 20+. Public staging URL required in v1. macOS and Linux supported.

For teams shipping with

Claude CodeClaude Code
CodexCodex
GitHub CopilotGitHub Copilot
CursorCursor
Amp

Core commands

Everything in the CLI runs against your hosted Zerocheck project. Browser execution happens in our cloud, so you don't install Chrome, Playwright, or any model keys locally.

1. Authenticate once per device

Terminal
npx zerocheck@latest login

Opens a browser to confirm a short code. Token saves to ~/.zerocheck/config.json (mode 0600). No API keys to manage.

2. Run tests against your staging URL

Terminal
npx zerocheck@latest run --url https://staging.yourapp.com

On an empty repo this also generates three starter tests from the page itself, writes them to ./zerocheck/tests/, and runs them. Live step updates stream back over a WebSocket.

3. Discover critical flows

Terminal
npx zerocheck@latest discover --url https://staging.yourapp.com --save

Crawls your app and saves suggested tests for review. Use--savewhen you also want local .yaml working copies. Approved hosted tests drive PR automation.

Available commands

The current CLI supports login, logout, whoami, validate, generate, discover, run, and doctor.

What it looks like

zerocheck run
$ npx zerocheck@latest run --url https://staging.acme.com
Connecting to api.tryzerocheck.com...
No tests at ./zerocheck/tests. Generating starter tests...
✓ Generated 3 starter tests:
  ./zerocheck/tests/homepage-loads.yaml
  ./zerocheck/tests/signup-flow.yaml
  ./zerocheck/tests/pricing-page.yaml

Starting run...  run_id=2026-04-18-a81bc4  3 tests

✓ homepage loads (3.2s)
✓ signup flow (8.7s)
✗ pricing page (4.1s)

● Run failed (16.1s)
  2 passed  1 failed  confidence 78%

Ready to try it?

Login takes under a minute. Your first run can create local .yaml working copies and execute them against your real staging URL, with screenshots and replay.

Start in the dashboardBook a walkthrough