CLI Commands

CLI Commands

Primary interface: zyvor-qa. Full examples: test-authoring.md.

Pipeline

Command	Description
zyvor-qa test	Hand-written smoke in tests/manual/ (no generation)
zyvor-qa test --grep @smoke	Filter tags
zyvor-qa run --source local [--spec PATH]	Full pipeline: parse → generate → execute → report
zyvor-qa run --source github [--spec PATH]	Specs/issues from ZYVOR_PRODUCT_REPO
zyvor-qa run --source github --expand-coverage	+ generate tests for uncovered routes
zyvor-qa generate --spec PATH	Generate only (no run)
zyvor-qa generate --source github --spec PATH	Generate from GitHub .md
zyvor-qa discover --source github	List coverage candidates/gaps
zyvor-qa create "…"	Natural-language test (LLM required)
zyvor-qa create "…" --execute	NL generate + run
zyvor-qa regression	Visual regression vs baselines
zyvor-qa regression --update-baselines	Capture new baselines

Journeys & quality

Command	Description
zyvor-qa flow <url> --steps FILE [--video]	Multi-step journey → one video + trace
zyvor-qa flow <url> --describe "…"	Journey from plain English
zyvor-qa har-replay <url> --mode record|replay --har PATH	HAR record/replay
zyvor-qa import-codegen FILE	Codegen JS/TS → flow steps
zyvor-qa route-sweep <url> --auto	Visual sweep all crawled routes
zyvor-qa api-test <base> --spec URL	OpenAPI contract (+ --workflow)
zyvor-qa auth-test <base> --api-login PATH	Login/session/negative auth
zyvor-qa realtime <url> --ws PATH	WebSocket/SSE assertions
zyvor-qa vitals <url>	Core Web Vitals (LCP/CLS/INP)

Serve / Mission Control

zyvor-qa serve --port 8080
zyvor-qa serve --tls          # HTTPS (self-signed under ~/.zyvor-qa/tls)

Dashboard: http://localhost:8080/dashboard · webhook: POST /webhook/github

Make targets

Target	Effect
make install	Python + npm + Chromium
make test / run / generate / serve	Common verbs
make regression / regression-update	Visual baselines
make rust	Build zyvor-diff
make docker	Build & run image
make k8s-validate / k8s-apply	Kubernetes manifests

Exit codes

Non-zero on test failure — safe for CI. See CI-CD and summary.json contract in Tutorial 15.