Analyze

gnost analyze runs quality analyzers and reports scores plus findings.

Current implementation target

• Python (for now)

• JavaScript / TypeScript / Java support is planned in upcoming releases.

Command reference

gnost analyze [path]

Key options

• -a / --analyzer Run only selected analyzers (repeatable).

• --parallel Run analyzers in parallel.

• -o / --out Write artifacts to:

  • docs/analysis/gnost_analysis.json

  • docs/analysis/gnost_analysis.html

• --max-findings N Limit findings collected per analyzer.

• --compact Emit compact JSON when -o is enabled.

• --timeout SECONDS Analyzer timeout for each analyzer.

• --no-progress Hide progress bar.

• --quiet Reduce logs to warnings/errors only.

• --verbose Print tracebacks for failures.

• --list-analyzers Print analyzer names and exit.

Output behavior

• Terminal: table with analyzer scores and severity counts.

• JSON: machine-readable results for CI or pipelines.

• HTML: interactive report for human review.

Open the report

After analysis output, use:

• gnost open report

• gnost open rpt (alias)

If needed, also use OS command directly:

• macOS: open docs/analysis/gnost_analysis.html

• Linux: xdg-open docs/analysis/gnost_analysis.html

• Windows: start "" docs\analysis\gnost_analysis.html

Example

gnost analyze . --parallel -o
gnost open report