NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev · #474 most downloaded on pub.dev
Uploads debug symbols to Sentry for server-side symbolication.
Last release 4 months ago
28 May 2026
Release timing varies
gaps range from 1 weeks to 4 months
Nearly every release is documented
notes for 25 of 25 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
36 releases · first in 2021
One column per quarter.
Bump sentry-cli to v2.58.6 by @szokeasaurusrex in #402
--selective flag to build snapshots to indicate the upload contains only a subset of images (#3268).java, .kt, .scala, .groovy), respecting .gitignore, and excluding common build output directories (#3260)--exclude option for custom glob patterns to exclude files/directories from source collection (#3260)eprintln! with log::info! for progress bar completion messages when the progress bar is disabled (e.g. in CI). This avoids spurious stderr output that some CI systems treat as errors (#3223).You can use the ignore_web_source_paths field: e.g ignore_web_source_paths: [test//*.js]
sentry-cli proguard uuid <PATH> to compute and print the UUID for a ProGuard mapping file (#3176).sentry-cli upload-proguard to sentry-cli proguard upload, aligning the API with similar upload commands like debug-files upload and sourcemaps upload (#3174). sentry-cli upload-proguard remains supported as an alias, so no migration is required.Log level not respected when configured via env variables
Upload Dart symbol mapping file
--extra-gen-snapshot-options=--save-obfuscation-map=<path> when building. Example: flutter build apk --obfuscate --split-debug-info=build/symbols --extra-gen-snapshot-options=--save-obfuscation-map=build/mapping.jsondart_symbol_map_path: build/mapping.jsondart_symbol_map_path must point directly to the mapping file (absolute or relative path), not a directory.sourceMaps.inject() for injecting debug IDs (#3088)--install-group parameter to sentry-cli build upload for controlling update visibility between builds (#3094)Upload Dart symbol mapping file
--extra-gen-snapshot-options=--save-obfuscation-map=<path> when building. Example: flutter build apk --obfuscate --split-debug-info=build/symbols --extra-gen-snapshot-options=--save-obfuscation-map=build/mapping.jsondart_symbol_map_path: /path/to/build/mapping.json# within your pubspec.yaml
sentry
# ... other Sentry config
dart_symbol_map_path: /path/to/build/mapping.json--extra-gen-snapshot-options=--save-obfuscation-map=<path> when building. Example: flutter build apk --obfuscate --split-debug-info=build/symbols --extra-gen-snapshot-options=--save-obfuscation-map=build/mapping.jsondart_symbol_map_path: build/mapping.jsondart_symbol_map_path must point directly to the mapping file (absolute or relative path), not a directory.Add additional path to check for iOS debug symbols
Add release and dist to sourcemaps upload command
releases.newDeploy() method. This method now accept a projects option (array of project slugs), aligning them with the Rust CLI's multi-project capabilities and matching the existing behavior of releases.new() and releases.uploadSourceMaps() (#3001).sentry-cli releases new command for users with self-hosted Sentry instances on versions older than 25.12.1 (#3068).sentry-cli releases list command ignored the --project option (#3048). The command now correctly can filter releases by a single project when supplied via --project. This change does not enable filtering by multiple projects, which has never been supported.Version 3.0.0 marks a major release of the Sentry Dart Plugin containing breaking changes for Flutter Web.
Version 3.0.0 marks a major release of the Sentry Dart Plugin containing breaking changes for Flutter Web.
sentry:
# ... other config
legacy_web_symbolication: truelegacy_web_symbolication which you can set to true if you want to keep using the old symbolication. It is set to false by default.sentry-cli 3.0.0 and above only officially supports Sentry SaaS and Sentry self-hosted versions 25.11.1 and higher. While many Sentry CLI features may, in practice, continue working with some older Sentry versions, continued support for Sentry versions older than 25.11.1 is not guaranteed. Changes which break support for Sentry versions below 25.11.1 may occur in minor or patch releases.
Sentry CLI now defines a semantic versioning policy. We did not explicitly define a versioning policy previously, and this new policy should give more clarity about what can change in minor or patch releases versus what requires a major version bump.
sentry-cli files ... and sentry-cli releases files ... subcommands (#2956). These commands provided functionality for managing release files, a feature that has been deprecated in Sentry. Users still using sentry-cli files upload to upload source maps should migrate to sentry-cli sourcemaps upload.sentry-cli sourcemaps explain command (#2947). The command had been deprecated for some time, since Sentry now has a better in-product debugging flow for source map problems via the "Unminify Code" button, which is displayed on any JavaScript issues which could not be unminified.sentry-cli send-metric ... subcommands (#3006). These commands have been deprecated, and the data they send is no longer accepted by Sentry.--api-key CLI flagSENTRY_API_KEY environment variableapi_key configuration file fieldapiKey option in the JavaScript APIupload-proguard subcommand's --app-id, --version, --version-code, --android-manifest, and --platform arguments (#2876, #2940, #2948). Users using these arguments should stop using them, as they are unnecessary. The information passed to these arguments is no longer visible in Sentry.--started argument from the sentry-cli releases finalize command (#2972). This argument is a no-op, so any users using it should simply stop using it.--use-artifact-bundle flag from sentry-cli sourcemaps upload (#3002). The flag was a no-op that only emitted a deprecation warning.The following changes only apply when using sentry-cli via the npm package @sentry/cli:
The SentryCli.execute method's live parameter now only takes boolean values (#2971). Setting live to true now behaves like 'rejectOnError' did previously, with a zero exit status resolving the returned promise with "success (live mode)" and a non-zero status rejecting the promise with an error message.
The option parameter to Releases.uploadSourceMaps no longer takes a live property (#2971). We now always execute the command with live set to true.
Removed the apiKey option from SentryCliOptions (#2935). If you are using apiKey, you need to generate and use an Auth Token via the authToken option, instead.
Removed the useArtifactBundle option from SentryCliUploadSourceMapsOptions (#3002). This deprecated option was a no-op that users should simply stop passing.
Drop support for Node.js <18. The minimum required Node.js version is now 18.0.0 (#2985).
The type export SentryCliReleases has been removed.
The JavaScript wrapper now uses named exports instead of default exports (#2989). You need to update your imports:
// Old (default import)
const SentryCli = require('@sentry/cli');
// New (named import)
const { SentryCli } = require('@sentry/cli');
For ESM imports:
// Old
import SentryCli from '@sentry/cli';
// New
import { SentryCli } from '@sentry/cli';
sentry-cli upload-proguard command now uses chunked uploading by default (#2918). Users who previously set the SENTRY_EXPERIMENTAL_PROGUARD_CHUNK_UPLOAD environment variable to opt into this behavior no longer need to set the variable.debugId field, per the TC39 Debug ID proposal (#3005). This change affects the sentry-cli sourcemaps inject command and, unless --no-rewrite is passed, the sentry-cli sourcemaps upload command. Sentry CLI can still read the debug_id field, but whenever the CLI writes or rewrites a source map, we always use debugId.sentry-cli build upload command now automatically tracks Sentry plugin versions from the SENTRY_PIPELINE environment variable (#2994). When SENTRY_PIPELINE contains a recognized Sentry plugin (e.g., sentry-gradle-plugin/4.12.0 or sentry-fastlane-plugin/1.2.3), the plugin version is written to the .sentry-cli-metadata.txt file in uploaded build archives, enabling the backend to store metadata for size analysis and build distribution tracking.Add missing prefix to source file upload
Merge pubspec.yaml and sentry.properties values
Support flavors in iOS symbol upload
Dart source context on web missing
Upload debug symbols for known release build paths and the configured symbols_path (#277) Previously, all debug symbols recognized by Sentry CLI were
symbols_path (#277)
Previously, all debug symbols recognized by Sentry CLI were uploaded (starting in the current directory by default).
Now, the plugin checks the paths where flutter build outputs debug symbols for release builds and only uploads those..dart files with upload-sourcemaps when upload_sources is enabled (#247)
upload_sources to opt in to Flutter web source contextAdd support for build files folder parameter
Problem 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)
Update env/config release and dist behaviour
release and dist behaviour (#217)
name@version.
If a build number is included in the version, it is utilized as dist.SENTRY_RELEASE and SENTRY_DIST environment variables take precedence over plugin config values.dist overrides version build number (#216)
release@1.0.0+1, specifying a custom dist value of 2 will update the version to release@1.0.0+2.--sentry-define (#198)sentry-cli (#224)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)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)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)difutil id subcommand (use debug-files check instead)upload-dsym command (use debug-files upload instead)releases upload-sourcemaps --rewrite a default behavior nowupload-dsym command (use debug-files upload instead) (breaking)~ restored in 2.0.2 as hidden
aliasdifutil id subcommand (use debug-files check instead) (breaking)~ restored in 2.0.2 as hidden
aliasmonitors command (support for this feature has been dropped) (breaking)~ - restored in 2.0.3 as
hidden commandbash-hook command (use 1.x if you still need the functionality) (breaking)~ - restored in 2.0.3 as
hidden commandnode 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 hide --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 crateUpdated the process dependency range to >=4.2.4 <6.0.0 (#202).
process dependency range to >=4.2.4 <6.0.0 (#202).
integration_test package with Flutter version 3.19.0Support reading config from sentry.properties file
CLICOLOR environment variable--validate and --rewrite in one command better for source map upload.Fixes org auth tokens with no URL not supported by bumping CLI to v2.21.2
Revert process from 5.0.0 to 4.2.4
Bumps process from 4.2.4 to 5.0.0.
--fingerprint support to send-eventBreaking Change: releases managed for react-native and mobile are now using the new
distribution feature. Use older versions of sentry-cli if you do not wish to manage
distributions on self hosted Sentry versions.
Support custom dist and release has precedence over the pubspec's name
--uuid parameter to upload-dsym--no-zips parameter to upload-dsym--derived-data parameter to upload-dsymReplace upload-dif to debug-files upload
Support http >= v1, system_info2 >= v4, file >= v7
sentry-cli releases propose-versionBump CLI from v2.13.0 to v2.17.5 (#86, #89, #90, #101, #103, #107, #114)
.env files--finalize option to automatically finalize releases on creationsentry-cli info command rendering and claritysentry react-native-xcodeAdd configuration ignore_missing
ignore_missing (#85)upload-dsyms when launched from xcode will now upload symbols in the background and
notify with OS X notifications about changesBump CLI from v2.12.0 to v2.13.0
### Features * Support release commits
Early exit when providing lower log level
Ability to configure url for on-premise server
Log real exitCode, stdout and stdout if available
Bump sentry-cli 1.69.1 which includes a fix for Dart debug symbols
Add org and project when creating releases
### Features * Sentry Dart Plugin
Rename configuration include_native_sources to upload_sources
Your coding agent can read these notes before it upgrades. Set up the MCP server →