Sentry CLI

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.

• Repo: https://github.com/getsentry/sentry-cli
• Docs: https://docs.sentry.io/cli/
• Compatibility: Sentry SaaS and Self-Hosted 24.11.1+

Installation

# npm
npm i -g @sentry/cli

# curl
curl -sL https://sentry.io/get-cli/ | bash

# Homebrew
brew install getsentry/tools/sentry-cli

# Docker
docker run --rm -v $(pwd):/work getsentry/sentry-cli --help

Configuration

# Interactive login
sentry-cli login

# Or set env vars
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).