> ## Documentation Index
> Fetch the complete documentation index at: https://docs.withgiga.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Reports & Recordings

> PDF reports and full session replays from every audit

# 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](/custom-domains) branding)
* Confidentiality notice
* Page numbers

### Retrieving the PDF

```bash theme={null}
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

```bash theme={null}
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:

```bash theme={null}
asciinema play recording.cast
```

Or upload it to [asciinema.org](https://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](/custom-domains), the PDF report and shareable links use your domain. This lets MSSPs deliver white-labeled reports to clients.

## Retention

| Plan        | Report retention | Recording retention |
| ----------- | ---------------- | ------------------- |
| Free        | 7 days           | 7 days              |
| Starter Pro | 90 days          | 90 days             |
| Max         | Unlimited        | Unlimited           |

After retention expiry, findings metadata is preserved but the PDF and recording assets are purged.

## Next steps

<Columns cols={2}>
  <Card title="Custom Domains" icon="globe" href="/custom-domains">
    White-label report URLs and PDF branding.
  </Card>

  <Card title="Security Score" icon="chart-line" href="/audits/security-score">
    How the grade on the cover page is calculated.
  </Card>
</Columns>