Sentry CLI Usage Guide Help users interact with Sentry from the command line using the sentry CLI. Prerequisites The CLI must be installed and authenticated before use. Installation curl https://cli.sentry.dev/install -fsS | bash curl https://cli.sentry.dev/install -fsS | bash -s -- --version nightly brew install getsentry/tools/sentry

Or install via npm/pnpm/bun

npm install -g sentry Authentication sentry auth login sentry auth login --token YOUR_SENTRY_API_TOKEN sentry auth status sentry auth logout Available Commands Auth Authenticate with Sentry sentry auth login Authenticate with Sentry Flags: --token - Authenticate using an API token instead of OAuth --timeout - Timeout for OAuth flow in seconds (default: 900) - (default: "900") Examples:

OAuth device flow (recommended)

sentry auth login

Using an API token

sentry auth login --token YOUR_TOKEN SENTRY_URL = https://sentry.example.com SENTRY_CLIENT_ID = your-client-id sentry auth login SENTRY_URL = https://sentry.example.com sentry auth login --token YOUR_TOKEN sentry auth logout Log out of Sentry Examples: sentry auth logout sentry auth refresh Refresh your authentication token Flags: --json - Output result as JSON --force - Force refresh even if token is still valid Examples: sentry auth refresh sentry auth status View authentication status Flags: --show-token - Show the stored token (masked by default) Examples: sentry auth status sentry auth token Print the stored authentication token sentry auth whoami Show the currently authenticated user Flags: --json - Output as JSON Org Work with Sentry organizations sentry org list List organizations Flags: -n, --limit - Maximum number of organizations to list - (default: "30") --json - Output JSON Examples: sentry org list sentry org list --json sentry org view View details of an organization Flags: --json - Output as JSON -w, --web - Open in browser Examples: sentry org view < org-slug

sentry org view my-org sentry org view my-org -w Project Work with Sentry projects sentry project create Create a new project Flags: -t, --team - Team to create the project under --json - Output as JSON sentry project list List projects Flags: -n, --limit - Maximum number of projects to list - (default: "30") --json - Output JSON -c, --cursor - Pagination cursor (use "last" to continue from previous page) -p, --platform - Filter by platform (e.g., javascript, python) Examples:

List all projects

sentry project list

List projects in a specific organization

sentry project list < org-slug

Filter by platform

sentry project list --platform javascript sentry project view View details of a project Flags: --json - Output as JSON -w, --web - Open in browser Examples:

Auto-detect from DSN or config

sentry project view

Explicit org and project

sentry project view < org

/ < project

Find project across all orgs

sentry project view < project

sentry project view my-org/frontend sentry project view my-org/frontend -w Issue Manage Sentry issues sentry issue list List issues in a project Flags: -q, --query - Search query (Sentry search syntax) -n, --limit - Maximum number of issues to list - (default: "25") -s, --sort - Sort by: date, new, freq, user - (default: "date") -t, --period - Time period for issue activity (e.g. 24h, 14d, 90d) - (default: "90d") --json - Output JSON -c, --cursor - Pagination cursor for / or multi-target modes (use "last" to continue) Examples:

Explicit org and project

sentry issue list < org

/ < project

All projects in an organization

sentry issue list < org

/

Search for project across all accessible orgs

sentry issue list < project

Auto-detect from DSN or config

sentry issue list

List issues in a specific project

sentry issue list my-org/frontend sentry issue list my-org/ sentry issue list frontend sentry issue list my-org/frontend --query "TypeError" sentry issue list my-org/frontend --sort freq --limit 20

Show only unresolved issues

sentry issue list my-org/frontend --query "is:unresolved"

Show resolved issues

sentry issue list my-org/frontend --query "is:resolved"

Combine with other search terms

sentry issue list my-org/frontend --query "is:unresolved TypeError" sentry issue explain Analyze an issue's root cause using Seer AI Flags: --json - Output as JSON --force - Force new analysis even if one exists Examples: sentry issue explain < issue-id

By numeric issue ID

sentry issue explain 123456789

By short ID with org prefix

sentry issue explain my-org/MYPROJECT-ABC

By project-suffix format

sentry issue explain myproject-G

Force a fresh analysis

sentry issue explain 123456789 --force sentry issue plan Generate a solution plan using Seer AI Flags: --cause - Root cause ID to plan (required if multiple causes exist) --json - Output as JSON --force - Force new plan even if one exists Examples: sentry issue plan < issue-id

After running explain, create a plan

sentry issue plan 123456789

Specify which root cause to plan for (if multiple were found)

sentry issue plan 123456789 --cause 0

By short ID with org prefix

sentry issue plan my-org/MYPROJECT-ABC --cause 1

By project-suffix format

sentry issue plan myproject-G --cause 0 sentry issue view View details of a specific issue Flags: --json - Output as JSON -w, --web - Open in browser --spans - Span tree depth limit (number, "all" for unlimited, "no" to disable) - (default: "3") Examples:

By issue ID

sentry issue view < issue-id

By short ID

sentry issue view < short-id

sentry issue view FRONT-ABC sentry issue view FRONT-ABC -w Event View Sentry events sentry event view View details of a specific event Flags: --json - Output as JSON -w, --web - Open in browser --spans - Span tree depth limit (number, "all" for unlimited, "no" to disable) - (default: "3") Examples: sentry event view < event-id

sentry event view abc123def456 sentry event view abc123def456 -w Api Make an authenticated API request sentry api Make an authenticated API request Flags: -X, --method - The HTTP method for the request - (default: "GET") -d, --data - Inline JSON body for the request (like curl -d) -F, --field ... - Add a typed parameter (key=value, key[sub]=value, key[]=value) -f, --raw-field ... - Add a string parameter without JSON parsing -H, --header ... - Add a HTTP request header in key:value format --input - The file to use as body for the HTTP request (use "-" to read from standard input) -i, --include - Include HTTP response status line and headers in the output --silent - Do not print the response body --verbose - Include full HTTP request and response in the output Examples: sentry api < endpoint

[ options ]

List organizations

sentry api /organizations/

Get a specific organization

sentry api /organizations/my-org/

Get project details

sentry api /projects/my-org/my-project/

Create a new project

sentry api /teams/my-org/my-team/projects/ \ --method POST \ --field name = "New Project" \ --field platform = javascript

Update an issue status

sentry api /issues/123456789/ \ --method PUT \ --field status = resolved

Assign an issue

sentry api /issues/123456789/ \ --method PUT \ --field assignedTo = "user@example.com"

Delete a project

sentry api /projects/my-org/my-project/ \ --method DELETE sentry api /organizations/ \ --header "X-Custom-Header:value" sentry api /organizations/ --include

Get all issues (automatically follows pagination)

sentry api /projects/my-org/my-project/issues/ --paginate Cli CLI-related commands sentry cli feedback Send feedback about the CLI sentry cli fix Diagnose and repair CLI database issues Flags: --dry-run - Show what would be fixed without making changes sentry cli setup Configure shell integration Flags: --install - Install the binary from a temp location to the system path --method - Installation method (curl, npm, pnpm, bun, yarn) --channel - Release channel to persist (stable or nightly) --no-modify-path - Skip PATH modification --no-completions - Skip shell completion installation --no-agent-skills - Skip agent skill installation for AI coding assistants --quiet - Suppress output (for scripted usage) sentry cli upgrade Update the Sentry CLI to the latest version Flags: --check - Check for updates without installing --force - Force upgrade even if already on the latest version --method - Installation method to use (curl, brew, npm, pnpm, bun, yarn) Repo Work with Sentry repositories sentry repo list List repositories Flags: -n, --limit - Maximum number of repositories to list - (default: "30") --json - Output JSON -c, --cursor - Pagination cursor (use "last" to continue from previous page) Team Work with Sentry teams sentry team list List teams Flags: -n, --limit - Maximum number of teams to list - (default: "30") --json - Output JSON -c, --cursor - Pagination cursor (use "last" to continue from previous page) Examples:

Auto-detect organization or list all

sentry team list

List teams in a specific organization

sentry team list < org-slug

Limit results

sentry team list --limit 10 sentry team list --json Log View Sentry logs sentry log list List logs from a project Flags: -n, --limit - Number of log entries (1-1000) - (default: "100") -q, --query - Filter query (Sentry search syntax) -f, --follow - Stream logs (optionally specify poll interval in seconds) --trace - Filter logs by trace ID (32-character hex string) --json - Output as JSON Examples:

Auto-detect from DSN or config

sentry log list

Explicit org and project

sentry log list < org

/ < project

Search for project across all accessible orgs

sentry log list < project

List last 100 logs (default)

sentry log list

Stream with default 2-second poll interval

sentry log list -f

Stream with custom 5-second poll interval

sentry log list -f 5

Show only error logs

sentry log list -q 'level:error'

Filter by message content

sentry log list -q 'database'

Show last 50 logs

sentry log list --limit 50

Show last 500 logs

sentry log list -n 500

Stream error logs from a specific project

sentry log list my-org/backend -f -q 'level:error' sentry log view View details of one or more log entries Flags: --json - Output as JSON -w, --web - Open in browser Examples:

Auto-detect from DSN or config

sentry log view < log-id

Explicit org and project

sentry log view < org

/ < project

< log-id

Search for project across all accessible orgs

sentry log view < project

< log-id

sentry log view 968c763c740cfda8b6728f27fb9e9b01 sentry log view 968c763c740cfda8b6728f27fb9e9b01 -w sentry log view my-org/backend 968c763c740cfda8b6728f27fb9e9b01 sentry log list --json | jq '.[] | select(.level == "error")' Trace View distributed traces sentry trace list List recent traces in a project Flags: -n, --limit - Number of traces (1-1000) - (default: "20") -q, --query - Search query (Sentry search syntax) -s, --sort - Sort by: date, duration - (default: "date") -c, --cursor - Pagination cursor (use "last" to continue from previous page) --json - Output as JSON sentry trace view View details of a specific trace Flags: --json - Output as JSON -w, --web - Open in browser --spans - Span tree depth limit (number, "all" for unlimited, "no" to disable) - (default: "3") sentry trace logs View logs associated with a trace Flags: --json - Output as JSON -w, --web - Open trace in browser -t, --period - Time period to search (e.g., "14d", "7d", "24h"). Default: 14d - (default: "14d") -n, --limit - Number of log entries (1-1000) - (default: "100") -q, --query - Additional filter query (Sentry search syntax) Issues List issues in a project sentry issues List issues in a project Flags: -q, --query - Search query (Sentry search syntax) -n, --limit - Maximum number of issues to list - (default: "25") -s, --sort - Sort by: date, new, freq, user - (default: "date") -t, --period - Time period for issue activity (e.g. 24h, 14d, 90d) - (default: "90d") --json - Output JSON -c, --cursor - Pagination cursor for / or multi-target modes (use "last" to continue) Orgs List organizations sentry orgs List organizations Flags: -n, --limit - Maximum number of organizations to list - (default: "30") --json - Output JSON Projects List projects sentry projects List projects Flags: -n, --limit - Maximum number of projects to list - (default: "30") --json - Output JSON -c, --cursor - Pagination cursor (use "last" to continue from previous page) -p, --platform - Filter by platform (e.g., javascript, python) Repos List repositories sentry repos List repositories Flags: -n, --limit - Maximum number of repositories to list - (default: "30") --json - Output JSON -c, --cursor - Pagination cursor (use "last" to continue from previous page) Teams List teams sentry teams List teams Flags: -n, --limit - Maximum number of teams to list - (default: "30") --json - Output JSON -c, --cursor - Pagination cursor (use "last" to continue from previous page) Logs List logs from a project sentry logs List logs from a project Flags: -n, --limit - Number of log entries (1-1000) - (default: "100") -q, --query - Filter query (Sentry search syntax) -f, --follow - Stream logs (optionally specify poll interval in seconds) --trace - Filter logs by trace ID (32-character hex string) --json - Output as JSON Traces List recent traces in a project sentry traces List recent traces in a project Flags: -n, --limit - Number of traces (1-1000) - (default: "20") -q, --query - Search query (Sentry search syntax) -s, --sort - Sort by: date, duration - (default: "date") -c, --cursor - Pagination cursor (use "last" to continue from previous page) --json - Output as JSON Whoami Show the currently authenticated user sentry whoami Show the currently authenticated user Flags: --json - Output as JSON Global Options All commands support the following global options: --help - Show help for the command --version - Show CLI version --log-level - Set log verbosity ( error , warn , log , info , debug , trace ). Overrides SENTRY_LOG_LEVEL --verbose - Shorthand for --log-level debug Output Formats JSON Output Most list and view commands support --json flag for JSON output, making it easy to integrate with other tools: sentry org list --json | jq '.[] | .slug' Opening in Browser View commands support -w or --web flag to open the resource in your browser: sentry issue view PROJ-123 -w