Command-line options
Commands, flags and exit codes, generated from the CLI's own vfk --help. The CLI guide covers output modes, logs and signals.
Commands
| Command | What it does |
|---|---|
vfk [run] [options] | Verify (selective locally, full in CI). |
vfk plan [options] | Show which checks would run and why. |
vfk logs [check...] | Show logs from the latest run. |
vfk init [--force] | Create verifika.config.json from package.json scripts and add "verify"/"verify:ci" scripts if absent. |
Selection
Applies to run and plan.
| Flag | Argument | What it does |
|---|---|---|
--all | Run every check. | |
-c, --check | <name> | Run only these checks and their dependencies (repeatable or comma-separated). |
--changed | Select by changes against changes.base, even in CI. | |
--changed-since | <ref> | Select by changes since merge-base(<ref>, HEAD), including uncommitted and untracked files. |
Execution
Applies to run.
| Flag | Argument | What it does |
|---|---|---|
-j, --concurrency | <n> | Maximum checks running at once (default 1). |
--fail-fast | Stop everything after the first failure. | |
--no-fail-fast | Run every selected check even after a failure. | |
--preview | <lines> | Failure preview lines per check (default 10, 0 = off). |
--no-live | Print progress line by line instead of a live status block (or set VERIFIKA_LIVE=0). |
Logs
| Flag | Argument | What it does |
|---|---|---|
--failed | Print logs of every failed check. | |
--tail | <lines> | Print only the last lines of each log. |
--run | <id> | Read a specific run instead of the latest. |
--no-pager | Print logs directly instead of through $PAGER (paging only happens on a terminal). |
Output
| Flag | Argument | What it does |
|---|---|---|
--mode | <mode> | human | agent | json | quiet (default: human on a terminal, agent otherwise; or set VERIFIKA_MODE). |
General
| Flag | Argument | What it does |
|---|---|---|
--config | <path> | Use this config file instead of searching upward. |
-h, --help | Show this help. | |
-v, --version | Show the version. |
Exit codes
| Code | Meaning |
|---|---|
0 | Passed or nothing to verify. |
1 | Verification failed. |
2 | Usage or configuration error. |
70 | Internal error. |
128+signal | Interrupted (130 SIGINT, 143 SIGTERM). |
Full help
text
vfk - run the checks your changes need, with minimal output
(vfk is short for verifika; the two commands are identical)
Usage:
vfk [run] [options] Verify (selective locally, full in CI)
vfk plan [options] Show which checks would run and why
vfk logs [check...] Show logs from the latest run
vfk init [--force] Create verifika.config.json from package.json scripts
and add "verify"/"verify:ci" scripts if absent
Selection (run, plan):
--all Run every check
-c, --check <name> Run only these checks and their dependencies
(repeatable or comma-separated)
--changed Select by changes against changes.base, even in CI
--changed-since <ref> Select by changes since merge-base(<ref>, HEAD),
including uncommitted and untracked files
Execution (run):
-j, --concurrency <n> Maximum checks running at once (default 1)
--fail-fast Stop everything after the first failure
--no-fail-fast Run every selected check even after a failure
--preview <lines> Failure preview lines per check (default 10, 0 = off)
--no-live Print progress line by line instead of a live
status block (or set VERIFIKA_LIVE=0)
Logs:
--failed Print logs of every failed check
--tail <lines> Print only the last lines of each log
--run <id> Read a specific run instead of the latest
--no-pager Print logs directly instead of through $PAGER
(paging only happens on a terminal)
Output:
--mode <mode> human | agent | json | quiet
(default: human on a terminal, agent otherwise;
or set VERIFIKA_MODE)
General:
--config <path> Use this config file instead of searching upward
-h, --help Show this help
-v, --version Show the version
Exit codes: 0 passed or nothing to verify, 1 verification failed,
2 usage or configuration error, 128+signal interrupted (130 SIGINT, 143 SIGTERM).
Docs: https://github.com/alexportelli12/verifika