Skip to content
axxbetadocs
v0.6.3next
GitHub

axx lint

View .mdOpen in Claude

Run the test-data isolation rules from the lint section of axx.yaml: each rule extracts values (ids, keys, names) from the files it selects, with a regular expression or a JSON path, and reports values that repeat where they must be unique, so scenarios sharing a database can run in parallel. Builtin checks also fail on a scenario with a second When or Then, and warn about SQL selection and trigger ordinals that cannot work. lint.config.mode: warn in axx.yaml, or –mode warn, makes the first only report too.

With paths, only findings touching those files or directories are reported (every file is still scanned: a value collides with occurrences anywhere).

Formats (repeatable, NAME or NAME:FILE; FILE is relative to axx.yaml): human grouped by rule, with file:line and the colliding value (default) json the –json envelope junit one test case per rule sarif SARIF 2.1.0 for code scanning (paths relative to the repository) github GitHub Actions ::error/::warning annotations

Exit codes: 0 clean (or only warnings, e.g. rules in warn mode), 2 invalid configuration, 3 violations.

Usage:
axx lint [paths...] [flags]
Examples:
axx lint
axx lint seeds/manifest-kestrel.yaml
axx lint --format github --format sarif:build/axx/lint.sarif
axx lint --mode warn
Flags:
-D, --define stringArray set a property for ${sys:name}, e.g. -D local.host=docker
-f, --format stringArray output NAME or NAME:FILE (repeatable): human, json, junit, sarif, github
-h, --help help for lint
--mode string override the mode of every rule, the built-in feature checks included: error or warn
--profile string apply profiles.<name> / axx.<name>.yaml, several comma-separated in order, like watch,ios (env: AXX_PROFILE)
--set stringArray set a key of axx.yaml for this run, over its files and profiles, e.g. --set run.workers=1 or --set packs.<pack>.<key>=value
Global Flags:
--compact print only what matters (auto-enabled for coding agents)
-c, --config string path to axx.yaml (default: search upward from the working directory)
--json emit machine-readable JSON (stable envelope)
--no-color disable colored output
-v, --verbose count increase log verbosity (-v, -vv)