Reports & Recordings

Every completed audit produces two deliverables: a PDF report for stakeholders and a full asciinema recording of every command GigaOps ran.

The PDF report

The PDF is generated automatically when the audit completes and is suitable for executives, auditors, and engineering leads.

Report structure

Cover page
  • Target domain and audit type
  • Security score (A+ to F) with color-coded badge
  • Severity breakdown (critical / high / medium / low / info counts)
  • Audit metadata (start time, completion time, duration, workspace)
Executive summary
  • One-paragraph overview of the engagement
  • Top three findings called out
  • High-level remediation priorities
Findings section
  • One page per finding (or multi-page for findings with rich evidence)
  • Severity badge in the finding header
  • Title, description, category
  • Evidence block in Courier monospace (the actual shell session / response)
  • Green-bordered recommendation section
  • Discovery timestamp
Engagement metadata
  • Full target list
  • Tooling versions
  • Phase-by-phase timing breakdown
Footer & pagination
  • WithGiga branding (or your custom domain branding)
  • Confidentiality notice
  • Page numbers

Retrieving the PDF

curl https://api.withgiga.ai/api/workspaces/{workspaceId}/audits/{auditId}/pdf \
  -H "Authorization: Bearer $GIGA_API_KEY"
Returns a presigned URL to the generated PDF. The file is named withgiga-audit-{target-slug}-{YYYY-MM-DD}.pdf.

Asciinema recording

Every engagement is captured as an asciinema recording — a full terminal session replay including every command GigaOps ran, every tool’s output, every screenshot trigger.

Why asciinema

  • Compact — a 2-hour engagement recording is typically 1–5 MB
  • Searchable — text-based, so you can grep through the entire session
  • Replayable — plays back at original speed with controllable pause/seek
  • Forensically complete — every byte the agent saw and wrote is captured

Retrieving the recording

curl https://api.withgiga.ai/api/workspaces/{workspaceId}/audits/{auditId}/recording \
  -H "Authorization: Bearer $GIGA_API_KEY"
Returns a presigned URL to the .cast file. Play it back locally:
asciinema play recording.cast
Or upload it to asciinema.org for shareable web playback.

Use cases for the recording

  • Verification — confirm exactly what was done during the engagement
  • Training — teach junior analysts by replaying real engagements
  • Audit trail — compliance evidence that an assessment was performed
  • Incident response — if a vulnerability is exploited later, compare to confirm the agent’s discovery process
  • Tuning — review what the agent attempted and didn’t, then write better autonomous briefs

Screenshots

GigaOps captures screenshots automatically at key moments during the engagement (typically: vulnerability discovery, login success, exfiltration confirmation). Screenshots are:
  • Embedded in the live dashboard view
  • Attached to relevant findings
  • Available via the API per-finding

Custom-domain branding

If you’ve configured a custom domain, the PDF report and shareable links use your domain. This lets MSSPs deliver white-labeled reports to clients.

Retention

PlanReport retentionRecording retention
Free7 days7 days
Starter Pro90 days90 days
MaxUnlimitedUnlimited
After retention expiry, findings metadata is preserved but the PDF and recording assets are purged.

Next steps

Custom Domains

White-label report URLs and PDF branding.

Security Score

How the grade on the cover page is calculated.