Export session data

Pull captured sessions out as NDJSON — one session, a time window, or everything in the trailing 30 days.

Pull captured sessions out of paper as NDJSON — for analysis, archiving, or feeding other tools. Prerequisite: authenticated paperctl.

Export

Export scope is required: a session id, a time window, or --all. A bare export is rejected so it never dumps everything by accident.

paperctl sessions export <session-id> --out session.ndjson
paperctl sessions export --since 2026-07-01T00:00:00Z --until 2026-07-15T00:00:00Z
paperctl sessions export --all --out all.ndjson

Output goes to the file named by --out, or to stdout. --all exports every session in the trailing 30 days.

Detail level

The default is one span-level record per turn. For full trace/span granularity:

paperctl sessions export <session-id> --detail traces --out session.ndjson

Handle exports with care

An export contains the full captured content of its sessions — prompts, responses, and tool output included. Treat the file like the sessions themselves: share it only with people who should see everything in it.

Copied to clipboard