CLI Reference

Complete reference for all SPECTRA commands and flags.


Global Usage

spectra [COMMAND] [OPTIONS] [INPUT]

Commands

spectra analyze

Analyze a scanner output file and produce ranked findings, attack chain analysis, and an executive summary.

spectra analyze [INPUT] [OPTIONS]

Arguments

ArgumentDescription
INPUTPath to the scanner output file. Omit to read from stdin.

Options

FlagTypeDefaultDescription
--scanner, -sstringautoForce scanner type: trivy, semgrep, generic. Auto-detected from file structure when omitted.
--format, -fstringmarkdownOutput format: markdown, json, or both.
--output, -opath(stdout)Output file path, without extension. SPECTRA appends .md and/or .json depending on --format.
--model, -mstringclaude-sonnet-5-5Claude model to use. Also read from SPECTRA_MODEL. See Configuration for models.
--think, -tflagoffRequest a summary of Claude’s reasoning during analysis.
--usage, -uflagoffPrint Anthropic API token usage (including cache reads and writes) after analysis. Useful for cost tracking.

Examples

# Basic Trivy analysis, Markdown output
spectra analyze trivy.json

# Both output formats, custom output path
spectra analyze trivy.json --format both --output reports/infra-scan-2026-05

# Force generic scanner for pentest notes
spectra analyze pentest.txt --scanner generic --format markdown --output reports/pt

# Pipe Semgrep JSON from stdin
cat semgrep.json | spectra analyze --scanner semgrep --format json --output reports/pr-42

# Print token usage after analysis
spectra analyze trivy.json --format both --output reports/run1 --usage

spectra --version

Print the installed SPECTRA version.

spectra --version

spectra --help

Print usage information.

spectra --help
spectra analyze --help

Exit Codes

CodeMeaning
0Analysis completed successfully
1Error: invalid or empty input, parse failure, or API error (authentication, rate limit, refusal)
2Invalid command-line usage (unknown flag or bad value)

Environment Variable Overrides

These environment variables (or .env entries) are read. A CLI flag takes precedence over its variable:

Environment VariableEquivalent Flag
SPECTRA_MODEL--model
ANTHROPIC_API_KEY(required)

Next: Configuration →