---
id: sentry-cli
version: "3.6.2"
license: FSL-1.1-MIT
license_treatment: permissive
maintenance: active
---

# sentry-cli — A command line utility to work with Sentry.

License: permissive · Maintenance: active · Downloads: 208.7K/mo

## What it is and what it does

Sentry CLI is the official command-line interface for Sentry, a platform for error tracking and performance monitoring. It provides a way to interact with Sentry from scripts, CI/CD pipelines, and local development workflows without using the web interface. The tool handles common tasks like uploading debug symbols and source maps (critical for stack trace symbolication), creating and managing releases, and querying Sentry data such as issues and logs.

The package is distributed as pre-built wheels for multiple platforms (macOS, Linux, Windows) and CPU architectures (x86_64, ARM, ARM64), so installation is straightforward on most systems. It has no Python runtime dependencies, only requiring Python 3.7 or later. The tool is actively maintained and officially supports Sentry SaaS and self-hosted versions 24.11.1 and above; older self-hosted deployments may need an older CLI version.

Use it for:

- Automate source map and debug symbol uploads in CI/CD pipelines to enable proper stack trace symbolication in Sentry.
- Create and manage Sentry releases programmatically as part of deployment workflows.
- Query and retrieve issue data, logs, or other Sentry information from command-line scripts or monitoring systems.
- Integrate Sentry operations into local development workflows or shell scripts without leaving the terminal.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A command-line tool for interacting with Sentry, enabling tasks like uploading debug symbols and source maps, managing releases, and accessing Sentry data such as issues and logs.

Yes. Sentry CLI is actively maintained, has no external runtime dependencies, and is the official tool for Sentry integration from the command line. It's well-suited for CI/CD pipelines and scripting. The permissive license and broad platform support make it a low-friction choice for teams already using Sentry. Install it if you need to automate Sentry tasks or integrate Sentry into your deployment pipeline.

## Install

pip install sentry-cli
uv add sentry-cli
poetry add sentry-cli

## Installing sentry-cli

Before you install: Medium install friction due to platform-specific wheels (10 variants across macOS, Linux, Windows, and ARM architectures), but the package is actively maintained with a recent release and no runtime dependencies to manage.

License in practice: Licensed under FSL-1.1-MIT (permissive), meaning you can use and modify the package freely with minimal restrictions.

Quickstart:

pip install sentry-cli
sentry-cli --version
sentry-cli releases list

Requires Python 3.7 or later; authentication token or API key needed to interact with Sentry instances.

Verify before relying:

- Whether the package works equally well with Sentry SaaS and self-hosted instances in practice.
- Performance characteristics when uploading large source maps or debug symbol files.
- Exact feature parity between sentry-cli 3.6.2 and the new AI-powered CLI mentioned in the description.

## Package facts

- License: FSL-1.1-MIT (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 208.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

sentry cli command line, upload source maps debug symbols, sentry release management, sentry issue tracking cli, error monitoring command line tool, error-tracking, ci-cd-integration, devops

[View on SkillFed](https://skillfed.io/packages/sentry-cli) · [View on PyPI](https://pypi.org/project/sentry-cli/)