See what’s been captured — yours and your organization’s — without leaving the terminal. Prerequisite: authenticated paperctl.
List recent sessions
paperctl sessions listReturns the most recent sessions first, with each session’s id, start time, turn count, tokens, cost, duration, and status.
Narrow it down
paperctl sessions list --limit 50 --sort total_cost_usd --direction desc
paperctl sessions list --since 2026-07-01T00:00:00Z --auth-subject <user-id>| Flag | Description |
|---|---|
--limit <n> |
Max rows to return (server default 50, max 200) |
--sort <col> |
last_active, started_at, turn_count, total_cost_usd, total_tokens, duration_ns, derived_status, or auth_subject |
--direction <dir> |
asc or desc |
--since / --until |
Bound to sessions active in an RFC3339 time window |
--auth-subject <id> |
Scope to a single user |
--cursor <cursor> |
Opaque pagination cursor from a previous response |
Listing operates on a trailing 30-day window.
JSON for scripts and agents
paperctl sessions list --jsonEmits the raw JSON response — session objects plus a pagination cursor — instead of formatted rows.