---
name: "Sentry"
description: Inspect Sentry issues, events, and releases, and manage source maps through the official `sentry-cli`.
version: 1
situations: sentry, errors, crashes, releases, monitoring
requires-secrets:
requires-packages:
requires-connector: sentry
---

# Sentry (`sentry-cli`)

Runs through Sentry's official CLI in your **bash** tool. The operator connected the account from 00's
skill store, so the auth token is already in place.

## First, know who you are

```
sentry-cli info
```

That prints the authenticated user and default org/project. If it reports no auth, tell the operator
to open **Skill store → Sentry → Connect**.

## Read

```
sentry-cli issues list --org ORG --project PROJECT --query "is:unresolved" --max-rows 25
sentry-cli releases list --org ORG --project PROJECT
sentry-cli releases info VERSION --org ORG --project PROJECT
```

For anything the CLI doesn't wrap, the Web API is one curl away — `sentry-cli` stores the token, so
ask the operator for a `SENTRY_AUTH_TOKEN` vault key if you need raw API access, rather than digging
the CLI's token out of its config file. Never read or print the contents of `~/.sentryclirc`.

## Triage flow that actually helps

1. List unresolved issues sorted by frequency, not recency — `--query "is:unresolved" --sort freq`.
2. For the top few, pull the culprit and the last-seen timestamp.
3. Correlate with the most recent release before writing a conclusion. A spike that starts exactly at
   a deploy is a different story from one that has been running for weeks.

## Write

```
sentry-cli issues resolve --org ORG --project PROJECT --id ISSUE_ID
sentry-cli releases new VERSION --org ORG --project PROJECT
sentry-cli releases finalize VERSION --org ORG --project PROJECT
```

Resolving or ignoring an issue is a claim that it's handled. Only do it when the operator asked, and
name the issue you're resolving.

## Never without being asked in this turn

Deleting releases, `sentry-cli releases delete`, bulk-resolving whole queries, or uploading source
maps to a project you weren't pointed at.