Skip to content
axxbetadocs
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 warn about SQL selection and trigger ordinals that cannot work.

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: error or warn
--profile string apply profiles.<name> / axx.<name>.yaml (env: AXX_PROFILE)
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)