replay

Search and inspect Session Replays

Commands

sentry replay event list <replay-target...>

List normalized events from a Session Replay

Arguments:

Argument	Description
<replay-target...>	[<org>/<project>] <replay-id> [path] or <replay-url> [path]

Options:

Option	Description
-k, --kind <kind>...	Event kind filter (navigation, click, tap, input, focus, blur, scroll, viewport, mutation, dom-snapshot, breadcrumb, network, console, error, span, web-vital, memory, video, mobile, unknown)
--path <path>	Filter events by parsed URL pathname
-q, --search <search>	Filter events by text in labels, messages, URLs, selectors, or data
--around <around>	Show an evidence window around this replay offset
-n, --limit <limit>	Number of events (1-1000) (default: "200")
--raw	Include raw source frame payloads in JSON output
-f, --fresh	Bypass cache, re-detect projects, and fetch fresh data

sentry replay list <org/project>

List recent Session Replays

Arguments:

Argument	Description
<org/project>	<org>/, <org>/<project>, or <project> (search)

Options:

Option	Description
-n, --limit <limit>	Number of replays (1-1000) (default: "25")
-q, --search <search>	Search query (Sentry replay search syntax)
-e, --environment <environment>...	Filter by environment (repeatable, comma-separated)
-s, --sort <sort>	Sort by: date, oldest, duration, errors, warnings, rage, dead, activity, or a raw replay sort field (default: "date")
-t, --period <period>	Time range: "7d", "2026-04-01..2026-05-01", ">=2026-04-01" (default: "7d")
-f, --fresh	Bypass cache, re-detect projects, and fetch fresh data
-c, --cursor <cursor>	Navigate pages: "next", "prev", "first" (or raw cursor string)

sentry replay summarize <replay-id-or-url...>

Summarize Session Replay behavior

Arguments:

Argument	Description
<replay-id-or-url...>	[<org>/<project>] <replay-id> or <replay-url>

Options:

Option	Description
--path <path>	Focus summary on events from this URL pathname
--limit-signals <limit-signals>	Maximum friction signals to include (0-50) (default: "10")
--limit-events <limit-events>	Maximum notable events to include (0-50) (default: "12")
-f, --fresh	Bypass cache, re-detect projects, and fetch fresh data

sentry replay view <replay-id-or-url...>

View a Session Replay

Arguments:

Argument	Description
<replay-id-or-url...>	[<org>/<project>] <replay-id> or <replay-url>

Options:

Option	Description
-w, --web	Open in browser
-f, --fresh	Bypass cache, re-detect projects, and fetch fresh data

All commands support --json for machine-readable output and --fields to select specific JSON fields.

Examples

List replays

# List recent replays for a project
sentry replay list my-org/frontend

# Search across all projects in an org
sentry replay list my-org/ --search "environment:production"

# Change the time window and sort
sentry replay list my-org/frontend --period 24h --sort errors

# Find recent sessions with replay search syntax
sentry replay list my-org/frontend \
  --search "url:*signup* count_errors:>0" --json

# Paginate through results
sentry replay list my-org/frontend -c next
sentry replay list my-org/frontend -c prev

# Output machine-readable data
sentry replay list my-org/frontend --json

View a replay

# View a replay by ID using auto-detected org/project context
sentry replay view 346789a703f6454384f1de473b8b9fcc

# View a replay with an explicit org
sentry replay view my-org/346789a703f6454384f1de473b8b9fcc

# View a replay with explicit org/project context
sentry replay view my-org/frontend/346789a703f6454384f1de473b8b9fcc

# Open a replay in the browser
sentry replay view my-org/346789a703f6454384f1de473b8b9fcc --web

Summarize behavior

# Summarize route flow, event counts, timings, and friction signals
sentry replay summarize my-org/346789a703f6454384f1de473b8b9fcc --json

# Focus the summary on a particular route path
sentry replay summarize my-org/346789a703f6454384f1de473b8b9fcc \
  --path /signup --json

Inspect replay events

# List normalized replay events for agent-readable inspection
sentry replay events my-org/346789a703f6454384f1de473b8b9fcc --json

# Focus on user actions and failures on a page
sentry replay events my-org/346789a703f6454384f1de473b8b9fcc \
  /signup --kind click,network,console,error --json

# Pull an evidence window around a timestamp
sentry replay events my-org/346789a703f6454384f1de473b8b9fcc \
  --around 01:23 --json