Guide for using the Sentry CLI to interact with Sentry from the command line. Use when the user asks about viewing issues, events, projects, organizations, making API calls, or authenticating with Sentry via CLI.
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Une commande directe contourne le prompt de vérification. Examinez la source avant de l'exécuter.
Guide for using the Sentry CLI to interact with Sentry from the command line. Use when the user asks about viewing issues, events, projects, organizations, making API calls, or authenticating with Sentry via CLI.
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.
-n, --limit <value> - Maximum number of projects to list - (default: "30")
--json - Output JSON
-c, --cursor <value> - Pagination cursor (use "last" to continue from previous page)
-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 <org/project>
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
-t, --period <value> - Time period for issue activity (e.g. 24h, 14d, 90d) - (default: "90d")
--json - Output JSON
-c, --cursor <value> - Pagination cursor — only for <org>/ mode (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 <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")
-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
--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
--force - Force upgrade even if already on the latest version
--method <value> - Installation method to use (curl, brew, npm, pnpm, bun, yarn)
Repo
Work with Sentry repositories
sentry repo list <org/project>
List repositories
Flags:
-n, --limit <value> - Maximum number of repositories to list - (default: "30")
--json - Output JSON
-c, --cursor <value> - Pagination cursor (use "last" to continue from previous page)
Team
Work with Sentry teams
sentry team list <org/project>
List teams
Flags:
-n, --limit <value> - Maximum number of teams to list - (default: "30")
--json - Output JSON
-c, --cursor <value> - 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 <org/project>
List logs from a project
Flags:
-n, --limit <value> - Number of log entries (1-1000) - (default: "100")
# 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 <org/project>
List recent traces in a project
Flags:
-n, --limit <value> - Number of traces (1-1000) - (default: "20")
