CLI overview

@archora/cli runs the same analyzer as the desktop app but exits with a structured JSON envelope, suitable for piping into other tools, archiving, or gating CI.

Synopsis

archora <command> [path] [options]

Commands

Command	What it does
analyze	Run analysis, output JSON envelope.
check	Exit non-zero when --fail-on rules trip.
diff	Diff a scan against a baseline JSON snapshot.
report	Render report (md, html, junit, json).

Common options

Option	Meaning
--output, -o <file>	Write to file instead of stdout.
--base <file>	Baseline JSON snapshot (diff / report / check).
--quiet	Suppress progress messages on stderr.
--help, -h	Show help.
--version, -v	Show CLI version.

Examples

# Quick analysis
archora analyze . > scan.json

# Gate CI on grade D / any cycles
archora check . --fail-on grade:D --fail-on cycles:0

# Markdown report for a PR comment
archora report . --format md -o report.md

# Diff against last week's baseline
archora diff . --base scan-baseline.json -o diff.json

See Exit codes and CI integration for putting this in pipelines.