Sentry CLI
https://github.com/getsentry/sentry-cli- Category
- Developer Tools
- Rank
- No. 361Tools index
- Pricing
- Open Source
- Type
- TOOL
- Builder
- getsentry
- GitHub
- 1.0k stars
- Latest release
- 3.7.1-snapshot.20260828.d6c8b48
- Date
About
Command-line tool for Sentry — upload source maps, manage releases, send events from CI.
What it does
Sentry CLI is Sentry’s official terminal client. It connects to SaaS or compatible self-hosted instances, handles build artifacts and release metadata, and lets engineers inspect issues and logs without leaving automation scripts or a shell.
Why it's ranked here
It is a practical choice for established Sentry delivery pipelines because it combines broad artifact handling, release operations, configuration, retries, and cross-platform distribution. The planned successor makes it less compelling for teams starting with agent-driven workflows.
What's good
The Rust binary covers source maps, debug symbols, releases, issues, and logs. Its source-map controls include rewriting, validation, deduplication, decompression, path adjustment, and multi-project uploads. Typed JavaScript bindings expose common release and source-map workflows while still allowing arbitrary command execution.
Tradeoffs
Self-hosted support depends on server capabilities, and some build commands require Sentry SaaS. Older self-hosted installations need an older CLI whose fixes will not be backported. The npm package also depends on platform-specific optional packages, so copied dependency folders or disabled optional dependencies can break installation.
How to use it well
Use it in Sentry-focused build and deployment automation that needs repeatable artifact processing and release bookkeeping. JavaScript teams can use the typed wrapper, while other environments can call the binary directly. Choose the separate new CLI when AI capabilities or first-class agent integration matter.
Technical notes+
Cargo.toml defines a Rust 2021 binary with clap, curl, sourcemap, symbolic, retry, compression, and Sentry dependencies; src/main.rs delegates entry to commands::main. src/config.rs merges global, project, properties-file, environment, and command-line configuration, while src/api/mod.rs implements pooled curl requests, authentication, proxy and certificate handling, compression, and retry-aware API access. package.json publishes @sentry/cli with platform binaries as optional dependencies, and lib/index.ts provides a typed wrapper around the executable. setup.py and setup.cfg package the Rust binary as a non-pure Python wheel. README.md also documents an Alpine-based Docker build.
Observed
- License
- FSL-1.1-MIT
- Primary language
- Rust, with TypeScript bindings and packaging code
- Interfaces
- Command-line binary and typed JavaScript wrapper
- Packaging
- Cargo source build, npm package, Python platform wheel, and Docker image
- Platform binaries
- macOS, Linux, and Windows packages cover multiple x86 and Arm architectures
- Service compatibility
- Supports Sentry SaaS and compatible Sentry Self-Hosted installations
Read from README.md, setup.py, setup.cfg, Cargo.toml, package.json, pyproject.toml, src/main.rs, lib/index.ts, lib/types.ts, lib/helper.ts, lib/logger.ts, src/config.rs, src/constants.rs, src/api/mod.rs, src/utils/mod.rs.
What it can do
Upload source maps to Sentry
Source map files → Uploaded source maps in Sentry project
Create and manage releases
Release version and metadata → Release record in Sentry
Send error events from CI
Error data and event information → Error events tracked in Sentry
Associate commits with releases
Git commit information and release version → Release with linked commit history
Deploy release to environments
Release version and environment name → Deployment record in Sentry
Configure project settings
Project configuration parameters → Updated Sentry project settings
Tags
Tech Stack
Media
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.