# Codex Rollout Report

> Generate a compact Markdown report from Codex rollout JSONL transcripts. Use when a user asks to inspect a Codex session, turn, rollout, transcript, timeline, final answer, tool calls, or token accounting from rollout files only.

- Skill: `savchart/codex-rollout-report` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add savchart/codex-rollout-report`
- Raw SKILL.md: https://api.skillmd.com/api/skills/savchart/codex-rollout-report/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: savchart (https://skillmd.com/u/savchart)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/savchart/codex-rollout-report

---


# Codex Rollout Report

## Purpose

Render a Codex rollout transcript into a readable Markdown report. This skill is intentionally rollout-only: it reads `rollout-*.jsonl` transcript files and writes a report artifact. It does not use semantic audit logs, OTel logs, Grafana, Loki, hooks, Docker, network calls, or repository state.

Hidden reasoning is not available and must not be inferred. The report may include visible assistant messages, visible final answers, tool call metadata, tool results, and token-count records that are present in the rollout transcript.

## Command

Use the bundled script:

```bash
python3 <skill-dir>/scripts/render_rollout_report.py --latest
```

Useful variants:

```bash
python3 <skill-dir>/scripts/render_rollout_report.py --rollout <path/to/rollout.jsonl>
python3 <skill-dir>/scripts/render_rollout_report.py --rollout <path/to/rollout.jsonl> --turn <turn_id>
python3 <skill-dir>/scripts/render_rollout_report.py --session <session_id>
python3 <skill-dir>/scripts/render_rollout_report.py --latest --out /tmp/codex/reports/
python3 <skill-dir>/scripts/render_rollout_report.py --latest --transcript-root <path/to/sessions>
```

Supported flags:

- `--rollout <path>`: read a specific rollout JSONL transcript.
- `--latest`: select the newest rollout containing a reportable completed turn.
- `--session <id>`: filter by session id while searching rollout transcripts.
- `--turn <id>`: render a specific turn from the selected transcript.
- `--transcript-root <path>`: search a custom sessions directory instead of `$CODEX_HOME/sessions` or `~/.codex/sessions`.
- `--out <path-or-dir>`: write to an exact Markdown file or to a directory.

## Output

Default output directory:

```text
/tmp/codex/reports/
```

On success the script prints:

```text
path: <report-path>
open: file://<report-path>
```

The report contains:

1. `Metadata`
2. `Prompt`
3. `Timeline`
4. `Final Answer`
5. `Files And Notes`

## Safety

- Keep reports under `/tmp/codex/reports/` unless the user explicitly provides another non-repository output path.
- Do not write reports inside detected Git worktrees.
- Do not modify repositories, hooks, Codex config, telemetry config, or background services.
- Treat token counts as rollout-derived and potentially incomplete.
- Treat visible assistant messages as visible transcript text, not hidden reasoning.

## Validation

```bash
python3 -m py_compile <skill-dir>/scripts/render_rollout_report.py
python3 <skill-dir>/scripts/render_rollout_report.py --help
```