swa.ml command-line tools

Validate complete swa.ml 2.1 models and export diagrams without installing VS Code. Requires Node.js 22 or newer. This package includes the Aliot Software Architecture validator and diagram renderer, with no runtime dependencies or install scripts.

npm install --global @voidaliot/swaml-cli
swaml-validate ./models --format json --no-config
swaml-diagram export --file model.swaml --view gv --out architecture.svg

Or run without a global install:

npx --package=@voidaliot/swaml-cli swaml-validate ./models --format github --strict
npx --package=@voidaliot/swaml-cli swaml-diagram export --file model.swaml --all --out-dir ./export

Supply all application dependencies together. Validation supports text, JSON, SARIF and GitHub annotations. Exports support SVG for General, Interconnect, Case, Sequence, Flow and Timing, and CSV for Grid. Source errors prevent export. --help documents arguments; --version reports the independent extension, language implementation and parser versions.

Validation exits 0 for success, 1 for model diagnostics and 2 for invalid arguments or I/O errors. These tools do not run use cases or tests. See the CLI guide and language reference.

The Aliot Freeware License in LICENSE applies to the CLI. The pinned language core and bundled dependencies retain their own licenses in SWAML-LICENSE and THIRD-PARTY-NOTICES.txt.