skills/sentry-cli/references/sourcemap.md

name, version, description, requires

name	version	description	requires
sentry-cli-sourcemap	0.33.0	Manage sourcemaps	bins auth sentry true

Sourcemap Commands

Manage sourcemaps

sentry sourcemap inject <directory>

Inject debug IDs into JavaScript files and sourcemaps

Flags:

• --ext <value> - Comma-separated file extensions to process (default: .js,.cjs,.mjs)
• --ignore <value> - Comma-separated glob patterns to exclude (gitignore-style)
• --ignore-file <value> - Path to a file with gitignore-style patterns to exclude
• --dry-run - Show what would be modified without writing
• --allow-empty - Exit successfully when no JS + sourcemap pairs are found (default: error out to catch silent build misconfigurations)

Examples:

# Inject debug IDs into all JS files in dist/
sentry sourcemap inject ./dist

# Preview changes without writing
sentry sourcemap inject ./dist --dry-run

# Only process specific extensions
sentry sourcemap inject ./build --ext .js,.mjs

sentry sourcemap upload <directory>

Upload sourcemaps to Sentry

Flags:

• --release <value> - Release version to associate with the upload
• --dist <value> - Distribution identifier to disambiguate builds within a release
• --url-prefix <value> - URL prefix for uploaded files (default: ~/) - (default: "~/")
• --ext <value> - Comma-separated file extensions to process (default: .js,.cjs,.mjs)
• --ignore <value> - Comma-separated glob patterns to exclude (gitignore-style)
• --ignore-file <value> - Path to a file with gitignore-style patterns to exclude
• --strip-prefix <value> - Strip a prefix from uploaded file paths (e.g. 'build/')
• --strip-common-prefix - Automatically strip the longest common path prefix from all files
• --no-rewrite - Upload files as-is without injecting debug IDs
• --allow-empty - Exit successfully when no JS + sourcemap pairs are found (default: error out to catch silent build misconfigurations)

Examples:

# Upload sourcemaps from dist/
sentry sourcemap upload ./dist

# Associate with a release
sentry sourcemap upload ./dist --release 1.0.0

# Set a custom URL prefix
sentry sourcemap upload ./dist --url-prefix '~/static/js/'

sentry sourcemap upload ./dist --allow-empty

All commands also support --json, --fields, --help, --log-level, and --verbose flags.