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 18 days ago
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
feat: Deprecate sourcemaps explain (#1797) by @loewenheim
sourcemaps explain (#1797) by @loewenheimfix(rn): Remove hermesc envs if hermes is disabled (#1754) by @krystofwoldrich
One column per quarter.
fix: Strip /api/0 prefix from endpoint URLs (#1752) by @loewenheim
/api/0 prefix from endpoint URLs (#1752) by @loewenheim--wait-for option (#1748) by @loewenheimfeat: Commands with a --wait flag now also have a --wait-for option that additionally puts a limit on the wait time. (#1748) by @loewenheim
--wait flag now also have a --wait-for <SECS> option that additionally puts a limit on the wait time. (#1748) by @loewenheimlogin now opens the org auth token creation page (#1737) by @loewenheim--wait flag now also have a --wait-for <SECS> option that additionally puts a limit on the
wait time. (#1748) by @loewenheimsymbolic updated to 12.4.1 (#1749) by @loewenheimfix(sourcemaps): Query parameters and fragments are removed from source mapping URLs (#1735) by @loewenheim
feat(rn): Allow custom bundle command and Expo export:embed in xcode wrap calls (#1723) by @krystofwoldrich
SENTRY_RELEASE in bash-hook (#1720) by @boozecSENTRY_RELEASE in bash-hook (#1720) by @boozecdeps: Bump sourcemap to 6.4.1 (#1715) by @kamilogorek
fix(injection): Make debug id injection sound (#1693) by @loewenheim
fix(set-commits): Allow --initial-depth to be specified alongside --auto (#1703) by @kamilogorek
feat: Allow the CLI binary path to be overridden (#1697) by @koddsson
fix: Correctly detect local binary when installing via npm
feat(issues): Add issues list command
issues list command (#1349)feat: Don't upload chunks that are already on the server (fixed version)
Revert "feat: Don't upload chunks that are already on the server (#1651)"
fix: Make artifact bundle creation deterministic
fix(inject): Add semicolon at the end of inject snippet (#1643) by @kamilogorek
ref(debug-files): Use temp file handle instead of keeping zips in memory (#1641) by @kamilogorek
ref(types): Add dedupe to available TS types (#1619) by @kamilogorek
ci: Use macos-latest to run build workflow (#1617) by @kamilogorek
sentry SDK to fix sending raw envelopes (#1616) by @Swatinemfeat: Print bundle id after artifact bundle creation (#1593) by @loewenheim
Add ability to send an Event as Raw Envelope (#1582) by @Swatinem
feat(js): Skip null as option same as undefined (#1579) by @mitsuhiko
sentry-cli debug-files bundle-jvm for bundling Java (and other JVM based languages) sources (#1551) by @adinauerfeat(debug_id): More determinism for JS debug IDs (#1577) by @mitsuhiko
fix(build) Hotfix allowing extra binaries during wheel build (#1575) by @ashwoods
feat(bash-hook): Add ability to specify tags for bash hook script
--use-artifact-bundle flag to force Artifact Bundles usage (#1557) (#1559)File::create to make sure files are truncated (#1562)fix: Attach checkin payload to monitor requests (#1550) by @kamilogorek
ref(crons): Prefer DSN based auth (#1545) by @kamilogorek
fix: Make sourcemap injection on upload opt-in
fix: Properly overwrite the sourcemap when injecting
sourcemaps inject (#1523)feat: Implement new chunk based upload for standalone artifact bundles
sourcemaps upload and print injection report (#1513)sourcemaps inject files (#1504)sourceMappingURL comment is always kept at the end of a file (#1511)fix: Include sources referenced but not embedded by an object file
ref: fix macos wheel tags, add musllinux tags (#1497) by @asottile-sentry
- No documented changes.
fix: Revert clap-rs v4 update and add regression test for 'releases files upload-sourcemap' (#1496) by @vaind
chore: update clap deprecations (#1487) by @vaind
debug-files print-sources command (#1476) by @vaindfeat: Added the --raw flag to send-envelope to allow sending envelopes without parsing or validation.
--raw flag to send-envelope to allow sending envelopes without parsing or validation. (#1468)SENTRY_TRACE_ID (#1472)feat: Enable portable PDB debug-files upload via Symbolic v11
SENTRY_TRACE_ID to executed process in monitors (#1441)SENTRY_MONITOR_ID to executed process in monitors (#1438)bash-hook (#1415)feat: Report spawn failures for monitors by @mitsuhiko
feat: Add --decompress option to JS types (#1402) by @FSchieber
--decompress option to JS types (#1402) by @FSchieberfeat: Replace npmlog dependency and restore support for Node v10 (#1392) by @mydea
npmlog dependency and restore support for Node v10 (#1392) by @mydeasentry-cli binary via JS script (#1389) by @kamilogorekserver_name in events via contexts sentry-rust feature (#1383) by @bengentilorg arguments (#1386) by @olksdrfix: Replace usage of eval to obfuscate binary path from bundlers (#1374) by @timfish
fix: Use forward slash for Windows binary location path (#1369) by @timfish
headers option to the JavaScript API (#1355) by @thibmeufix: paths argument for debug-files find should take a value (#1346) by @kamilogorek
fix: Update symbolic to fix spurious EOF errors (#1339) by @Swatinem
fix: Use direct plist env vars fallback when called within xcode itself (#1311) by @kamilogorek
fix: Fallback to xcodebuild vars for faulty Info.plist files (#1310) by @kamilogorek
feat: Allow for selecting frame in sourcemaps explain (#1293) by @kamilogorek
ref: Print better error when processing appcenter paths (#1287) by @kamilogorek
ci: Disable rustup self-update (#1278) by @kamilogorek
ref: Dont print install progressbar for nonTTY and CI=1 (#1270) by @kamilogorek
fix: Allow for using --auth-token with login command (#1266) by @kamilogorek
feat: Compute and upload il2cpp line mappings (#1248) by @loewenheim
feat: Don't upload chunks that are already on the server (fixed version)
feat: Add sourcemap explain command to debug production sourcemaps (#1235) by @kamilogorek
sourcemap explain command to debug production sourcemaps (#1235) by @kamilogorekorganizations list command (#1213) by @kamilogorekno-zips option for debug-files upload (#1239) by @saf-eVERSION to SENTRY_CLI_VERSION in install readme (#1227) by @kamilogorekget-cli readme with our docs; add version specifier (#1225) by @kamilogorekProblem statement:
Uploading source maps is a common source of frustration. Source maps are also one of the great value adds to our in product experience. We want to automate supporting customers with frequent issues.
https://docs.sentry.io/platforms/javascript/sourcemaps/troubleshooting_js/
_Outcome: _
Developers will be provided with a tool to help them discover any issues they may have when uploading source maps
Sentry support will have a tool and docs to suggest to customers to hopefully first discover issues, and second at least know what their problem is NOT.
Key measurements:
Can we find a way to track in zendesk the number of times the sentry-cli “y-tho“ functionality was useful
Additional
This is something users would run locally so I do not think we can track usage exactly what was not covered in y-tho
Possible second milestone:
https://github.com/getsentry/rust-sourcemap/tree/master/cli
By: @kamilogorek (#1235)
ref: Prevent @vercel/nft and similar tools from including binary file in their bundles (#1207) by @kamilogorek
ref: Make --header a global flag so its position independent
--header a global flag so its position independent (#1194)monitors as hidden command w. integration tests (#1196)bash-hook as hidden command w. integration tests (#1197)fix: Remove fetch.FetchError usage in favor of catch-all clause (#1193) by @kamilogorek
fix: Allow hyphenated release names with any flags position (#1187) by @kamilogorek
Breaking changes are denotated with _(breaking)_ tag, and appropriate required changes are provided for each entry.
This is the first, long-overdue major release in over 5 years of sentry-cli's life. Some APIs were removed, some reworked, some newly added.
Most of introduced API changes are backward compatible through hidden aliases, so there is no immediate need for users developing 3rd party tools to make all the changes immediatelly. We do however encourage everyone to do it sooner or later, as deprecated items will be removed in the next major releases.
Breaking changes are denotated with (breaking) tag, and appropriate required changes are provided for each entry.
debug-files command, which is a joined functionality of difutil and upload-dif commands.deploys command, which was extracted from releases deploys subcommand.files command, which was extracted from releases files subcommand.sourcemaps upload command, which was extracted from releases files upload-sourcemaps subcommand.sourcemaps resolve command.--header argument, which supports multiple occurences, to configure outgoing requests--quiet/--silent flags to allow silencing stdout output (This flag is currently implemented only for selected subcommands)difutil id subcommand (use debug-files check instead) (breaking)monitors command (support for this feature has been dropped) (breaking)react-native codepush subcommand (use react-native appcenter instead) (breaking)react-native-gradle and react-native-xcode commands (use react-native gradle and react-native xcode instead) (breaking)upload-dsym command (use debug-files upload instead) (breaking)react-native xcode --verbosereleases new --refreleases list --no-abbrevreleases upload-sourcemaps --verbosereleases upload-sourcemaps --rewrite (it's a default behavior now)upload-dif --upload-symbol-mapsbash-hook command (use 1.x if you still need the functionality; it will eventually be ported as a separate repository - https://github.com/getsentry/sentry-cli-bash-hook) (breaking)crash_reporting related code and with_crash_reporting crate feature (no required changes) (breaking)SENTRY_NO_PROGRESS_BAR env var in favor of SENTRYCLI_NO_PROGRESS_BAR (rename env variable) (breaking)node version to v12 (update node version) (breaking)--header argument of releases files upload command to --file-header (rename flag) (breaking)CUSTOM_HEADER to SENTRY_HEADER and defaults.custom_header to http.header (rename env variable or update config file) (breaking)ignore-empty for releases set-commits a default behavior and remove --ignore-empty flag (remove --ignore-empty usage) (breaking)--quiet flag for releases upload-sourcemaps command--quiet flag for difutil check command--auth-token a global argumentProgressBar instances and logs always write to stderrfailure to anyhow crateBreaking changes are denotated with _(breaking)_ tag, and appropriate required changes are provided for each entry.
Breaking changes are denotated with (breaking) tag, and appropriate required changes are provided for each entry.
--header argument, which supports multiple occurences, to configure outgoing requests--quiet/--silent flags to allow silencing stdout output (This flag is currently implemented only for selected subcommands)--quiet flag for releases upload-sourcemaps command--quiet flag for difutil check command--auth-token a global argumentignore-empty for releases set-commits a default behavior and remove --ignore-empty flag (remove --ignore-empty usage) (breaking)ProgressBar instances and logs always write to stderrfailure to anyhow cratebash-hook command (use 1.x if you still need the functionality; it will eventually be ported as a separate repository - https://github.com/getsentry/sentry-cli-bash-hook) (breaking)crash_reporting related code and with_crash_reporting crate feature (no required changes) (breaking)difutil id subcommand (use difutil check instead) (breaking)monitors command (support for this feature has been dropped) (breaking)react-native codepush subcommand (use react-native appcenter instead) (breaking)react-native-gradle and react-native-xcode commands (use react-native gradle and react-native xcode instead) (breaking)SENTRY_NO_PROGRESS_BAR env var in favor of SENTRYCLI_NO_PROGRESS_BAR (rename env variable) (breaking)upload-dsym command (use upload-dif instead) (breaking)react-native xcode --verbosereleases new --refreleases list --no-abbrevreleases upload-sourcemaps --verbosereleases upload-sourcemaps --rewrite (it's a default behavior now)upload-dif --upload-symbol-maps--header argument of releases files upload command to --file-header (rename flag) (breaking)CUSTOM_HEADER to SENTRY_HEADER and defaults.custom_header to http.header (rename env variable or update config file) (breaking)node version to v12 (update node version) (breaking)Your coding agent can read these notes before it upgrades. Set up the MCP server →