`cybros report`

Fetch a scan's report and findings, and render it as a table, JSON, or Markdown — optionally writing it to a file.

Synopsis

cybros report SCAN_ID [OPTIONS]

Arguments

Argument	Description
`SCAN_ID`	The scan id to report on.

Options

Flag	Default	Description
`--format`	`table`	Output format: `table`, `json`, or `md`.
`--output`	—	Write the output to a file instead of stdout.

Plus the global flags. Note: --json (global) forces JSON output regardless of --format.

Examples

Human-readable table

cybros report scan_8a1b...

╭─ Report — scan scan_8a1b… ───────────────────╮
│ Status: completed                             │
│ Total findings: 12                            │
│ Risk score: 63   Credits: 40                  │
╰───────────────────────────────────────────────╯
       Severity breakdown
┏━━━━━━━━━━┳━━━━━━━┓
┃ Severity ┃ Count ┃
┡━━━━━━━━━━╇━━━━━━━┩
│ critical │   1   │
│ high     │   3   │
└──────────┴───────┘
                          Findings
┏━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ Severity ┃ Rule          ┃ Title         ┃ Location   ┃
┡━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ critical │ py.sql-inject │ SQL injection │ app/db.py:88│
└──────────┴───────────────┴───────────────┴────────────┘

Export Markdown (for a PR comment or ticket)

cybros report scan_8a1b... --format md --output findings-report.md

Wrote findings-report.md

The Markdown includes the status, totals, a severity table, and a findings table with rule ids and locations.

JSON output

cybros report scan_8a1b... --format json --output scan-out.json
# or stream it:
cybros --json report scan_8a1b... | jq '.report.risk_score'

The JSON payload has two keys: report (the scan report) and findings (up to 50 findings).

Exit codes

Code	When
`0`	Report fetched / written.
`1`	Unknown scan or API error.
`2`	Not authenticated.

cybros report