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

bash

curl https://cli.sentry.dev/install -fsS | bash

# Or install via npm/pnpm/bun
npm install -g sentry

Authentication

bash

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:

bash

# 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:

bash

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:

bash

sentry auth refresh

sentry auth status

View authentication status

Flags:

--show-token - Show the stored token (masked by default)

Examples:

bash

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:

bash

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:

bash

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:

bash

# 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:

bash

# 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:

bash

# 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:

bash

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:

bash

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:

bash

# 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:

bash

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:

bash

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

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:

bash

# 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:

bash

# 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
```

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:

bash

sentry org list --json | jq '.[] | .slug'

Opening in Browser

View commands support

-w

--web

flag to open the resource in your browser:

bash

sentry issue view PROJ-123 -w

sentry-cli

NPX Install

Tags

SKILL.md Content

Sentry CLI Usage Guide

Prerequisites

Installation

Authentication

Available Commands

Auth

sentry auth login

sentry auth logout

sentry auth refresh

sentry auth status

sentry auth token

Org

sentry org list

sentry org view <org>

Project

sentry project list <org>

sentry project view <target>

Issue

sentry issue list <target>

sentry issue explain <issue>

sentry issue plan <issue>

sentry issue view <issue>

Event

sentry event view <args...>

Api

sentry api <endpoint>

Cli

sentry cli feedback <message...>

sentry cli fix

sentry cli setup

sentry cli upgrade <version>

Repo

sentry repo list <org>

Log

sentry log list <target>

sentry log view <args...>

Trace

sentry trace list <target>

sentry trace view <args...>

Issues

sentry issues <target>

Orgs

sentry orgs

Projects

sentry projects <org>

Repos

sentry repos <org>

Logs

sentry logs <target>

Traces

sentry traces <target>

Output Formats

JSON Output

Opening in Browser

`sentry auth login`

`sentry auth logout`

`sentry auth refresh`

`sentry auth status`

`sentry auth token`

`sentry org list`

`sentry org view <org>`

`sentry project list <org>`

`sentry project view <target>`

`sentry issue list <target>`

`sentry issue explain <issue>`

`sentry issue plan <issue>`

`sentry issue view <issue>`

`sentry event view <args...>`

`sentry api <endpoint>`

`sentry cli feedback <message...>`

`sentry cli fix`

`sentry cli setup`

`sentry cli upgrade <version>`

`sentry repo list <org>`

`sentry log list <target>`

`sentry log view <args...>`

`sentry trace list <target>`

`sentry trace view <args...>`

`sentry issues <target>`

`sentry orgs`

`sentry projects <org>`

`sentry repos <org>`

`sentry logs <target>`

`sentry traces <target>`