CLI Commands

CLI Commands

Primary interface: argus. Full examples: test-authoring.md.

Pipeline

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

Journeys & quality

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

Serve / Mission Control

argus serve --port 8080
argus serve --tls          # HTTPS (self-signed under ~/.argus/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.