| name | Sentry CLI |
| description | Manage Sentry releases, upload debug symbols and source maps, send events, monitor crons, and stream logs. Use when an agent needs to create releases, upload source maps, manage debug info files, or send test events to Sentry. |
Sentry CLI
Official CLI for Sentry. Manages releases, debug information files, source maps, cron monitors, logs, and event sending. Used in CI/CD pipelines and build processes.
Installation
npm i -g @sentry/cli
curl -sL https://sentry.io/get-cli/ | bash
brew install getsentry/tools/sentry-cli
docker run --rm -v $(pwd):/work getsentry/sentry-cli --help
Configuration
sentry-cli login
export SENTRY_AUTH_TOKEN=<token>
export SENTRY_ORG=<org-slug>
export SENTRY_PROJECT=<project-slug>
Config can also live in .sentryclirc or ~/.sentryclirc.
Key Commands
Release Management
sentry-cli releases list --format json
sentry-cli releases new <version>
sentry-cli releases set-commits <version> --auto
sentry-cli releases files <version> upload-sourcemaps ./dist
sentry-cli releases finalize <version>
sentry-cli releases deploys <version> new -e production
Debug Information Files
sentry-cli debug-files check <path>
sentry-cli debug-files upload <path>
sentry-cli debug-files list
Send Events
sentry-cli send-event -m "Test event"
sentry-cli send-event -m "Error occurred" -l error --logfile /var/log/app.log
Logs
sentry-cli logs list
sentry-cli logs stream
Cron Monitors
sentry-cli monitors list
sentry-cli monitors run <monitor-slug> -- <command>
Agent-Friendly Features
--format json for structured output- Auth via
SENTRY_AUTH_TOKEN, SENTRY_ORG, SENTRY_PROJECT env vars
- Non-interactive release and deploy management
- Source map and debug symbol upload for CI/CD
- Cron wrapping with
monitors run
See Also
For interactive issue management, AI-powered root cause analysis, and natural language commands, see the new Sentry developer CLI (sentry command — separate from sentry-cli).
