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/
Latest stable
3.8.2
Last release 1 months ago
22 Oct 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
302 releases · first in 2017
Drag across the ruler to compare, or tap a release to open it.
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 crateYour coding agent can read these notes before it upgrades. Set up the MCP server →
Breaking 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)fix: Return promise from download binary when SENTRYCLI_SKIP_DOWNLOAD is set (#1869) by @lforst
SENTRYCLI_SKIP_DOWNLOAD is set (#1869) by @lforstNothing published for this version
feat: Expose downloadBinary function to install binary
Nothing published for this version
ci: Use macos-latest to run build workflow (#1800) by @loewenheim
v1 tag config to ensure we do not publish as latest (d0f521b5) by @mydeaThis release fixes the checksum mismatch from 1.75.1.
feat(backport): Update sourcemap to 6.2.3 to correctly handle protocol-only sourceRoot
sourcemap to 6.2.3 to correctly handle protocol-only sourceRoot (#1586)feat(backport): Replace npmlog dependency in order to avoid vulnerability
npmlog dependency in order to avoid vulnerability (#1445)feat: Replace usage of eval to obfuscate binary path from bundlers
deps: Add resolution to bump ansi-regex to version ^3.0.1
ansi-regex to version ^3.0.1 (#1281)TempFile robustness on Windows (#1256)ci: Add merge target (f9a2db38) by @kamilogorek
deps: Update symbolic and git-rs crates (#1170) by @kamilogorek
revert: ref: Dont run install script using node binary #1151 (#1155) by @kamilogorek
ref: Make org and project flags position independent (#1153) by @kamilogorek
ref: Dont run install script using node binary (#1151) by @kamilogorek
install: Rename SENTRY_NO_PROGRESS_BAR flag to SENTRYCLI_NO_PROGRESS_BAR (#1132) by @kamilogorek
feat: Allow for using local binary through SENTRYCLI_USE_LOCAL env (#1129) by @kamilogorek
feat: Add checksum validation for installed binaries (set SENTRYCLI_SKIP_CHECKSUM_VALIDATION to opt-out)
SENTRYCLI_SKIP_CHECKSUM_VALIDATION to opt-out) (#1123)gold (#1124)feat: Use default xcode values for plist struct
fix: Dont include debug_id during assemble when not PDBs are not supported
debug_id during assemble when not PDBs are not supported (#1110)--all flag (#1108)feat: Add CUSTOM_HEADER support to JS wrapper
CUSTOM_HEADER support to JS wrapper (#1077)SENTRYCLI_SKIP_DOWNLOAD flag for preventing download (#1074)ParseDif::Object value to prevent large enum variant (#1094)dsym to dif with a fallback (#1103)project flag for releases command (#1065)feat: Add optional positional argument to send-event that allows to specify a path to JSON serialized events
send-event that allows to specify a path to JSON serialized events (#1058)SENTRY_CLI_NO_EXIT_TRAP unbound variable (#1059)feat: Add SENTRY_CLI_NO_EXIT_TRAP flag to control EXIT trap in bash-hook command
SENTRY_CLI_NO_EXIT_TRAP flag to control EXIT trap in bash-hook command (#1050)vscRemote TS type (#1052)feat: Add no-upload flag for upload-dif command
no-upload flag for upload-dif command (#1044)upload-sourcemaps command (#1048)SENTRY_DOTENV_PATH (#1046)SOURCE_VERSION first prior to HEROKU_SLUG_COMMIT in Heroku (#1045)misc: Re-release of 1.69.0 due to malformed artifacts
1.69.0 due to malformed artifactsfeat: Print upload context details
SENTRYCLI_LOG_STREAM variable (#1010)armv7 whenarch="arm" (#1024)debug_id for object files (#981)symbolic to 8.3.1 (#1033)upload-symbol-maps flag for upload-dif command (#1017)feat: Add ability for include in JS sourcemap upload options to be an object
include in JS sourcemap upload options to be an object (#1001)fix: Correctly resolve paths with hashes in url_to_bundle_path
url_to_bundle_path (#1000)started/finished to number|string, add ignoreEmpty to JS API (#999)npm_config_cache_folder to function of getting cache (#998)feat: Print sourcemaps/files operations timings information
feat: Add --ignore-empty flag to releases set-commit command, that will not bail command when no patchset is created
--ignore-empty flag to releases set-commit command, that will not bail command when no patchset is
created (#993)--raw and --delimiter flags to releases list command (#994)feat: Allow to define a custom release and dist for XCode SourceMaps upload
release and dist for XCode SourceMaps upload (#967)CUSTOM_HEADER env variable and http.custom_header config (#970)ignoreMissing flag for setCommit command to JS API (#974)feat: Allow for ignoring missing commits in set-commit with --ignore-missing flag
--ignore-missing flag (#963)ref: Rely on spawn process error for detecting command presence
fix: Redirect spawned JS process outputs to /dev/null instead of filling up pipe buffers
/dev/null instead of filling up pipe buffers (#949)upload-dif to follow symlinks to make it inline with difutil behavior (#948)feat: Add TypeScript SentryCli types
SentryCli types (#934)feat: List logging levels on CLI output
fix: Correctly detect hidden Swift symbols
arm64 as aarch64 in install script (#917)ref: is_outdated should not report when release contains version older than latest
is_outdated should not report when release contains version older than latest (#899)fix: Detect debug information in MIPS binaries
http_proxy config value in the handler directly (#893)fix: Add missing underscores for template in bash hook
arm64 and universal binaries (#873)Sentry-cli will not upgrade to the arm64 build automatically, if you're currently running on Rosetta 2. To install the
arm64 version:
uname -m in your terminal.sentry-cli.fix: Restore release modification calls to use put request, while preserving restore/archive capability
feat: Added support for WASM debug info files
feat: Allows the user to specify multiple projects for a release
feat: Expose environment configuration in javascript
feat: Allow for passing custom timestamp with send-event
send-event (#826)IA32 (#824)fix: Use updated release name format during upload process
feat: Add support for architectures other than x86/x64 when running installation script
--confirm flag to skip confirmation prompt during uninstall command (#812)7.5.0 (#813)fix: Path handling edgecases for upload-dif
upload-dif (#795)fix: Default to sending local commits if no repos linked
feat: Release files batch upload
feat: Add --no-environ parameter to bash-hook
--no-environ parameter to bash-hook (#745)SENTRY_NO_PROGRESS_BAR env var (#754)newDeploy JS api (#755)feat: releases deploys JavaScript API
releases deploys JavaScript API (#741)--log-level should be case insensitive (#740)fix: Dont panic on unknown log level
fix: Correctly store child process before attaching handlers
This release sets `node.engine: >=8` which makes it incompatible with Node v6 If you need to support Node v6, please pin your dependency to 1.52.1 or
This release sets node.engine: >=8 which makes it incompatible with Node v6
If you need to support Node v6, please pin your dependency to 1.52.1
or use selective version resolution: https://classic.yarnpkg.com/en/docs/selective-version-resolutions/
fix: Respect configFile for release commands invoked through JS API
configFile for release commands invoked through JS API (#700)feat: Add an optional argument to override the entire release name for a CodePush release
g/global flag for login command (#690)INFOPLIST_OTHER_PREPROCESSOR_FLAGS (#682)propose-version (#681)bitbucket_server to reference url check (#668)env.SENTRY_PROPERTIES rather than global process.env (#667)react-native xcode uses regex to detect Debug builds (#665)fix: Skip files larger than 1MB
One column per quarter.