NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm · #2079 most downloaded on npm
A command line utility to work with Sentry. https://docs.sentry.io/hosted/learn/cli/
Last release today
16 Sep 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
300 releases · first in 2017
fix(sourcemaps): Fix mismatches between path and URL on Windows (#2414) by @BYK
fix(sourcemaps): Exclude skipped files from bundle file count (#2397) by @a-hariti
semver@5.* dependencies (#2399) by @szokeasaurusrexsemver@6.* (#2400) by @szokeasaurusrexsemver@^7.* dependencies (#2398) by @szokeasaurusrexcross-spawn@7.0.X (#2396) by @szokeasaurusrexcross-spawn@^6.0.5 (#2395) by @szokeasaurusrexOne column per quarter.
This release is a re-release of 2.42.0. There are no code changes to the CLI. We are performing this re-release because 2.42.0 failed to publish to Do
This release is a re-release of 2.42.0. There are no code changes to the CLI. We are performing this re-release because 2.42.0 failed to publish to Docker Hub.
feat: Deprecate --use-artifact-bundle option (#2349) by @szokeasaurusrex
With this release, we now build and publish multi-architecture (arm64 and aarch64) Docker images for Sentry CLI.
--use-artifact-bundle option (#2349) by @szokeasaurusrexuseArtifactBundle JS option (#2348) by @szokeasaurusrex<details> <summary><h3>Non-user-facing changes</h3></summary>
docker (#2390) by @szokeasaurusrexurl crate (#2379) by @szokeasaurusrexunnecessary_wraps for add_debug_id_references (#2369) by @szokeasaurusrexunnecessary_wraps for add_sourcemap_references (#2368) by @szokeasaurusrexunnecessary_wraps lint for SourceMapsProcessor::add (#2367) by @szokeasaurusrexlookup_pos not return Option (#2366) by @szokeasaurusrexApi::with_body return Self (#2363) by @szokeasaurusrexwith_retry return Self (#2365) by @szokeasaurusrexprogress_bar_mode return Self (#2364) by @szokeasaurusrexunnecessary_wraps lint for set_auth (#2362) by @szokeasaurusrexResult from Config::from_file (#2361) by @szokeasaurusrexclippy::unnecessary_wraps lint (#2358) by @szokeasaurusrex-D warnings (#2359) by @szokeasaurusrex--log-level parsing (#2356) by @szokeasaurusrex</details>
build: Replace dotenv with dotenvy (#2351) by @szokeasaurusrex
dotenv with dotenvy (#2351) by @szokeasaurusrex
.env filesbuild: Bump symbolic to 12.13.3 (#2346) by @szokeasaurusrex
symbolic to 12.13.3 (#2346) by @szokeasaurusrexmemmap2 (#2340) by @szokeasaurusrexdebug-files upload when file is too big (#2331) by @szokeasaurusrexcollect (#2333) by @szokeasaurusrexfeat(debugid): Update debug ID snippet to write on globalThis when available (#2301) by @lforst
globalThis when available (#2301) by @lforst<details> <summary><h3>Non-user-facing changes</h3></summary>
We made several refactors and added several tests in this release. These changes should not affect users.
upload-dif reference from poll_assemble (#2321) by @szokeasaurusrexrender_detail take Option<&str> (#2317) by @szokeasaurusrexupload_difs_chunked (#2316) by @szokeasaurusrexupload module to options (#2315) by @szokeasaurusrexChunkOptions a struct (#2314) by @szokeasaurusrex&str in DifUpload struct (#2307) by @szokeasaurusrexpoll_assemble (#2300) by @szokeasaurusrex/ to uploaded Proguard file name (#2304) by @szokeasaurusrextry_assemble options parameter (#2299) by @szokeasaurusrexChunkedUploadOptions to indicate they are set by server (#2298) by @szokeasaurusrexChunked<ProguardMapping> for proguard upload (#2296) by @szokeasaurusrexChunkedDifRequest take Cow<'_, str> for name (#2295) by @szokeasaurusrexMappingRef with ProguardMapping (#2294) by @szokeasaurusrexproguard utils submodule (#2293) by @szokeasaurusrexByteView (#2292) by @szokeasaurusrexChunkedDifRequest (#2290) by @szokeasaurusrexNamed trait to Assemblable (#2289) by @szokeasaurusrexpoll_assemble generic (#2287) by @szokeasaurusrexToAssemble traittry_assemble_dif genericChunkedDifMatch with generic ChunkedObjectusize in get_sha1_checksums signatureassert_cmd test manager</details>
fix(sourcemaps): Correctly read files with debug_id and debugId (#2268) by @loewenheim
feat(proguard): Introduce experimental chunk uploading feature (#2264) by @szokeasaurusrex
debugId field in sourcemaps (#2222)assert_cmd as a dev dependencySENTRY_DUMP_REPONSE environment variable (#2212)allow(dead_code) from update utils (#2216)allow(dead_code) (#2215)<details> <summary><h3>Changes to tests</h3></summary>
with_header_matcher types (#2261) by @szokeasaurusreximpl Into<Matcher> for with_matcher (#2260) by @szokeasaurusrexwith_reponse_body parameter to mockito (#2259) by @szokeasaurusrex200 (#2258) by @szokeasaurusrexmockito mocking library (#2254) by @szokeasaurusrexTestManager in new chunk upload test (#2253) by @szokeasaurusrexTestManager struct for uniform test setup (#2252) by @szokeasaurusrexmock_common_endpoints refactor (#2251) by @szokeasaurusrexmock_common_upload_endpoints (#2250) by @szokeasaurusrexmock_common_upload_endpoints into module (#2249) by @szokeasaurusrexmocking to mock_endpoint_builder (#2248) by @szokeasaurusrexEndpointOptions to MockEndpointBuilder (#2247) by @szokeasaurusrexEndpointOptions (#2246) by @szokeasaurusrexEndpointOptions (#2245) by @szokeasaurusrextrycmd tests with RUST_BACKTRACE=0 (#2242) by @szokeasaurusrextarget_os (#2240) by @szokeasaurusrexbash_hook tests together (#2226)assemble endpoint call</details>
deps: Update symbolic to 12.12.0 (#2210) by @loewenheim
meta: Remove .vscode directory from version control (#2208) by @szokeasaurusrex
.vscode directory from version control (#2208) by @szokeasaurusrexmain to indicate it does not return (#2192) by @szokeasaurusrexcommands::main does not return (#2191) by @szokeasaurusrexfeat(errors): Print backtrace when RUST_BACKTRACE=1 (#2189) by @szokeasaurusrex
RUST_BACKTRACE=1 (#2189) by @szokeasaurusrex--auth-token (#2172) by @szokeasaurusrexWith this change, the --force-foreground flag is no longer needed, since we always upload in the foreground. The flag is now a deprecated no-op.
All Xcode uploads are now executed in the foreground, which should allow for easier debugging of any problems that occur while uploading files during the build process, since errors will be logged directly within Xcode.
With this change, the --force-foreground flag is no longer needed, since we always upload in the foreground. The flag is now a deprecated no-op.
There are no code changes in this release. It is being performed to test an update to the release build process.
There are no code changes in this release. It is being performed to test an update to the release build process.
There are no code changes in this release. It is a re-release of 2.36.4, which we are making because 2.36.4 and 2.36.3 failed to publish to PyPI.
There are no code changes in this release. It is a re-release of 2.36.4, which we are making because 2.36.4 and 2.36.3 failed to publish to PyPI.
This releases fixes includes a bugfix (#2171 by @szokeasaurusrex) for #2169. The bug caused any command run with sentry-cli monitors run to not be exe
This releases fixes includes a bugfix (#2171 by @szokeasaurusrex) for #2169. The bug caused any command run with sentry-cli monitors run to not be executed whenever sending the cron checkin to Sentry failed, e.g. during a Sentry outage or due to some other network failure. With the bugfix, we log the error and execute the program even when there was an error sending the checkin.
We recommend that all users using sentry-cli monitors run upgrade to Sentry CLI version 2.36.4 immediately.
build: Upgrade curl-sys (#2164) by @szokeasaurusrex
curl-sys (#2164) by @szokeasaurusrexref(metrics): Deprecate send-metric commands (#2154) by @szokeasaurusrex
--project in deploys new subcommand (#2160) by @szokeasaurusrexsend-metric commands (#2154) by @szokeasaurusrexFix a bug where background Xcode uploads sometimes failed
Log when file not added to source bundle (#2146) by @szokeasaurusrex
12.11.0. This fixes a bug where uploading source files sometimes failed when any of the files were not UTF-8 encodedfix: Only warn about mismatched URLs when they are different (#2143) by @szokeasaurusrex
upload-proguard on 507 status (#2141) by @szokeasaurusrexbuild: Bump symbolic to 12.10.1 (#2134) by @szokeasaurusrex
12.10.1 (#2134) by @szokeasaurusrex
Error class in debugId injection snippet (#2132) by @Lms24fix(react-native): Fix RN 0.75 node binary build fail (#2131) by @krystofwoldrich
This release contains a fix for a bug where auth tokens would, under the following circumstances, be logged to stdout:
This release contains a fix for a bug where auth tokens would, under the following circumstances, be logged to stdout:
--auth-token)info or debug
warn, so users using the default log level were unaffected by this bugWe now redact the --auth-token argument and anything else that looks like it might be an auth token when logging the arguments that the Sentry CLI was called with (see #2115 and #2118 for details).
Recognize new format user tokens (prefixed with sntryu_) (#2100) by @szokeasaurusrex
sntryu_) (#2100) by @szokeasaurusrexfiles upload (#2107)build: Bump curl to 0.4.46 in Cargo.toml (#2099) by @szokeasaurusrex
curl to 0.4.46 in Cargo.toml (#2099) by @szokeasaurusrexcurl-sys (#2075) by @szokeasaurusrexRelease performed for technical reasons. This release is identical to 2.32.0.
Release performed for technical reasons. This release is identical to 2.32.0.
docs(commands): Add info about clap Derive API (#2066) by @elramen
Fix regressions related to releases set-commits command, which were introduced in 2.31.1.
releases set-commits command, which were introduced in 2.31.1.fix(proguard): Don't require auth token with --no-upload flag (#2047) by @markushi
check passed a directory (#2034) by @szokeasaurusrexWith this change, dSYM uploads to the legacy endpoint and release file uploads are routed to the region URL directly (e.g. to https://us.sentry.io ins
With this change, dSYM uploads to the legacy endpoint and release file uploads are routed to the region URL directly (e.g. to https://us.sentry.io instead of https://sentry.io). This change only affects users using the CLI to interact with SaaS Sentry; everything stays the same for self-hosted users.
make lint only with default features (#1994) by @szokeasaurusrexRelease made for technical reasons. There are no code changes in this version.
Release made for technical reasons. There are no code changes in this version.
Release made for technical reasons. There are no code changes in this version.
Release made for technical reasons. There are no code changes in this version.
fix: Handle .env errors (#1987) by @szokeasaurusrex
This release re-enables Python releases. There are no code changes.
This release re-enables Python releases. There are no code changes.
fix(sourcemaps): allow complex file extensions (#1976) by @szokeasaurusrex
The monitors run subcommand now no longer accepts --auth-token or other means of authentication using token-based auth. It is now required to use DSN
The monitors run subcommand now no longer accepts --auth-token or other means of authentication using token-based auth. It is now required to use DSN based auth to monitor cron jobs using the sentry-cli.
Updated version 2.29.0 changelog. No code changes.
Updated version 2.29.0 changelog. No code changes.
This release fixes the behavior of sourcemaps inject and sourcemaps upload. We now treat minified and non-minified source files the same way in both c
This release fixes the behavior of sourcemaps inject and sourcemaps upload. We now treat minified and non-minified source files the same way in both commands, which was always the desired behavior, and is also consistent with our JS bundler plugins.
Please be aware that from now on, sourcemaps inject will inject debug IDs into all JS source files at the path provided to the command. If you only wish for some of the files to have debug IDs injected, you need to modify the path(s) passed to sourcemaps inject or you need to use the --ignore or --ignore-file options to exclude the files you do not wish to inject the debug IDs into.
In the sourcemaps upload command, we have eliminated the "Minified Scripts" section in the Source Maps Upload Report. Instead, these minified scripts will appear under "Scripts."
Sentry CLI now validates that you have provided an auth token whenever you run a command that requires authentication to succeed. If you fail to provide an auth token when running such a command, the Sentry CLI will exit with an error message explaining that the auth token is required but missing.
.cjs and .mjs to default sourcemaps upload extensions (#1961) by @szokeasaurusrexfix(deploys): Revert "fix(deploys): Use --project argument (#1930)" (#1942) by @szokeasaurusrex
--project argument (#1930)" (#1942) by @szokeasaurusrexfix(deploys): Use --project argument (#1930) by @szokeasaurusrex
--project argument (#1930) by @szokeasaurusrexThis release re-enables releases to PyPI, in addition to the following fix:
This release re-enables releases to PyPI, in addition to the following fix:
--project argument (#1930) by @szokeasaurusrexNew cron monitor configuration options (#1922) by @szokeasaurusrex
sentry-cli monitors run command now has two new command line arguments: --failure-issue-threshold and --recovery-threshold. These arguments allow the user to specify the number of consecutive failed checkins that trigger an issue to be created and the number of successful checkins that trigger the issue to be resolved, respectively.Prefer --url argument over empty auth token URL (#1914) by @szokeasaurusrex
--url argument over empty auth token URL (#1914) by @szokeasaurusrexdsyms/associate API usage (#1886) by @Swatinemmeta: Revert "meta: Temporarily disable npm targets for v1 release (#1903)" (#1908) by @szokeasaurusrex
- No documented changes.
- No documented changes.
fix: Upload Xcode debug files and source maps background upload (#1896) by @krystofwoldrich
curl issue on Windows (#1815) by @xpirtfix(api): Fix panic that occurred when sentry-cli login called with --auth-token (#1893) by @szokeasaurusrex
sentry-cli login called with --auth-token (#1893) by @szokeasaurusrexRevert #1885, which was causing an error in the `sentry-cli login` command (#1889) by @szokeasaurusrex
sentry-cli login command (#1889) by @szokeasaurusrexfeat(sourcemaps): Improve sourcemaps resolve command output (#1880) by @szokeasaurusrex
sourcemaps resolve command output (#1880) by @szokeasaurusrexref: Removed unneeded identity map (#1883) by @szokeasaurusrex
map (#1883) by @szokeasaurusrexref: upgrade git2 so safe.directory is implemented more correctly (#1866) by @asottile-sentry
build: Bump tempfile dependency (#1857) by @szokeasaurusrex
releases propose-version error (#1854) by @szokeasaurusrexmonitors run command's --timezone argument (#1847) by @szokeasaurusrexref: Transition to binaries over npm
ref: Transition to binaries over npm (#1836)
This release contains no changes and was done for technical purposes.
This release contains no changes and was done for technical purposes.
This release contains no changes and was done for technical purposes.
This release contains no changes and was done for technical purposes.
This release contains no changes and was done for technical purposes.
This release contains no changes and was done for technical purposes.
This release contains no changes and was done for technical purposes.
This release contains no changes and was done for technical purposes.
Improved error message if a project slug is missing (#1811) by @cleptric
curl issue on Windows (#1815) by @xpirtsourceRoot handling (#1818) by @loewenheimYour coding agent can read these notes before it upgrades. Set up the MCP server →