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, one row per session: id, name, model, status, turn count, cost, and last-active time. Sorting can also use fields beyond the displayed columns, like total_tokens and duration_ns — see the flags below.
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.