Use when the user asks to inspect Sentry issues or events, summarize recent production errors, or pull basic Sentry health data via the Sentry CLI; perform read-only queries using the `sentry` command.
sentry auth login or set SENTRY_AUTH_TOKEN as an env var..env files, source code, config defaults, and directory names. Only specify <org>/<project> if auto-detection fails or picks the wrong target.24h, environment production, limit 20.--json when processing output programmatically. Use --json --fields to select specific fields and reduce output size.sentry schema <resource> to discover API endpoints quickly.If the CLI is not installed, give the user these steps:
curl https://cli.sentry.dev/install -fsS | bashsentry auth loginsentry auth statusUse the sentry CLI for all queries. It handles authentication, org/project detection, pagination, and retries automatically. Use --json for machine-readable output.
sentry issue list \
--query "is:unresolved environment:production" \
--period 24h \
--limit 20 \
--json --fields shortId,title,priority,level,status
If auto-detection doesn't resolve org/project, pass them explicitly:
sentry issue list {your-org}/{your-project} \
--query "is:unresolved environment:production" \
--period 24h \
--limit 20 \
--json
sentry issue view {ABC-123} --json
Use the short ID format (e.g., ABC-123), not the numeric ID.
sentry issue view {ABC-123}
sentry issue events {ABC-123} --limit 20 --json
sentry event view {your-org}/{your-project}/{event_id} --json
sentry issue explain {ABC-123}
sentry issue plan {ABC-123}
For endpoints not covered by dedicated CLI commands, use sentry api:
sentry api /api/0/organizations/{your-org}/ --method GET
Use sentry schema to discover available API endpoints:
sentry schema issues
org_slug, project_slug: auto-detected by the CLI from DSNs, env vars, and directory names. Override with positional {your-org}/{your-project} if auto-detection fails.time_range: default 24h (pass as --period 24h).environment: default prod (pass as part of --query, e.g., environment:production).limit: default 20 (pass as --limit).search_query: optional --query parameter, uses Sentry search syntax (e.g., is:unresolved, assigned:me).issue_short_id: use directly with sentry issue view.{your-org}{your-project}{ABC-123}Example prompt: "List the top 10 open issues for prod in the last 24h." Expected: ordered list with titles, short IDs, counts, last seen.