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

# 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 <value> - Authenticate using an API token instead of OAuth
• --timeout <value> - 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 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

Org

Work with Sentry organizations

sentry org list

List organizations

Flags:

• --limit <value> - Maximum number of organizations to list - (default: "30")
• --json - Output JSON

Examples:

sentry org list

sentry org list --json

sentry org view <org>

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 list <org>

List projects

Flags:

• -n, --limit <value> - Maximum number of projects to list - (default: "30")
• --json - Output JSON
• -p, --platform <value> - 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 <target>

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 <target>

List issues in a project

Flags:

• -q, --query <value> - Search query (Sentry search syntax)
• -n, --limit <value> - Maximum number of issues to return - (default: "10")
• -s, --sort <value> - Sort by: date, new, freq, user - (default: "date")
• --json - Output as JSON

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 <issue>

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 <issue>

Generate a solution plan using Seer AI

Flags:

• --cause <value> - 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 <issue>

View details of a specific issue

Flags:

• --json - Output as JSON
• -w, --web - Open in browser
• --spans <value> - 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 <args...>

View details of a specific event

Flags:

• --json - Output as JSON
• -w, --web - Open in browser
• --spans <value> - 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 <endpoint>

Make an authenticated API request

Flags:

• -X, --method <value> - The HTTP method for the request - (default: "GET")
• -F, --field <value>... - Add a typed parameter (key=value, key[sub]=value, key[]=value)
• -f, --raw-field <value>... - Add a string parameter without JSON parsing
• -H, --header <value>... - Add a HTTP request header in key:value format
• --input <value> - 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 <message...>

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 <value> - Installation method (curl, npm, pnpm, bun, yarn)
• --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 <version>

Update the Sentry CLI to the latest version

Flags:

• --check - Check for updates without installing
• --method <value> - Installation method to use (curl, npm, pnpm, bun, yarn)

Repo

Work with Sentry repositories

sentry repo list <org>

List repositories

Flags:

• -n, --limit <value> - Maximum number of repositories to list - (default: "30")
• --json - Output JSON

Team

Work with Sentry teams

sentry team list <org>

List teams

Flags:

• -n, --limit <value> - Maximum number of teams to list - (default: "30")
• --json - Output JSON

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 <target>

List logs from a project

Flags:

• -n, --limit <value> - Number of log entries (1-1000) - (default: "100")
• -q, --query <value> - Filter query (Sentry search syntax)
• -f, --follow <value> - Stream logs (optionally specify poll interval in seconds)
• --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 <args...>

View details of a specific log entry

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 <target>

List recent traces in a project

Flags:

• -n, --limit <value> - Number of traces (1-1000) - (default: "20")
• -q, --query <value> - Search query (Sentry search syntax)
• -s, --sort <value> - Sort by: date, duration - (default: "date")
• --json - Output as JSON

sentry trace view <args...>

View details of a specific trace

Flags:

• --json - Output as JSON
• -w, --web - Open in browser
• --spans <value> - Span tree depth limit (number, "all" for unlimited, "no" to disable) - (default: "3")

Issues

List issues in a project

sentry issues <target>

List issues in a project

Flags:

• -q, --query <value> - Search query (Sentry search syntax)
• -n, --limit <value> - Maximum number of issues to return - (default: "10")
• -s, --sort <value> - Sort by: date, new, freq, user - (default: "date")
• --json - Output as JSON

Orgs

List organizations

sentry orgs

List organizations

Flags:

• --limit <value> - Maximum number of organizations to list - (default: "30")
• --json - Output JSON

Projects

List projects

sentry projects <org>

List projects

Flags:

• -n, --limit <value> - Maximum number of projects to list - (default: "30")
• --json - Output JSON
• -p, --platform <value> - Filter by platform (e.g., javascript, python)

Repos

List repositories

sentry repos <org>

List repositories

Flags:

• -n, --limit <value> - Maximum number of repositories to list - (default: "30")
• --json - Output JSON

Teams

List teams

sentry teams <org>

List teams

Flags:

• -n, --limit <value> - Maximum number of teams to list - (default: "30")
• --json - Output JSON

Logs

List logs from a project

sentry logs <target>

List logs from a project

Flags:

• -n, --limit <value> - Number of log entries (1-1000) - (default: "100")
• -q, --query <value> - Filter query (Sentry search syntax)
• -f, --follow <value> - Stream logs (optionally specify poll interval in seconds)
• --json - Output as JSON

Traces

List recent traces in a project

sentry traces <target>

List recent traces in a project

Flags:

• -n, --limit <value> - Number of traces (1-1000) - (default: "20")
• -q, --query <value> - Search query (Sentry search syntax)
• -s, --sort <value> - Sort by: date, duration - (default: "date")
• --json - Output as JSON

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