From f93c8a514463013cd52a70fd64a687955d3a5e0e Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Mon, 15 Jun 2026 12:12:17 +0000 Subject: [PATCH 1/6] fix: correct Homebrew formula license to FSL-1.1-Apache-2.0 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The Homebrew formula template in .craft.yml declared the license as FSL-1.1-MIT, but the actual license (LICENSE.md, package.json, README) is FSL-1.1-Apache-2.0. Co-authored-by: Miguel Betegón --- .craft.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.craft.yml b/.craft.yml index ffac3629a..2ca1e359f 100644 --- a/.craft.yml +++ b/.craft.yml @@ -38,7 +38,7 @@ targets: desc "Sentry command-line tool for error monitoring and debugging" homepage "https://cli.sentry.dev" version "{{version}}" - license "FSL-1.1-MIT" + license "FSL-1.1-Apache-2.0" if OS.mac? if Hardware::CPU.arm? From 03faf7e4d02e6b41938dba6ed6d22b35f9899023 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Mon, 15 Jun 2026 12:12:34 +0000 Subject: [PATCH 2/6] docs: clarify that npm installs require manual sentry cli setup MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The agentic-usage page implied that package manager installs (npm, pnpm, bun, yarn) automatically install agent skills. In reality, only curl and Homebrew installs run sentry cli setup automatically — npm has no postinstall hook. Co-authored-by: Miguel Betegón --- docs/src/content/docs/agentic-usage.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/docs/src/content/docs/agentic-usage.md b/docs/src/content/docs/agentic-usage.md index f18193b1a..1517d7a01 100644 --- a/docs/src/content/docs/agentic-usage.md +++ b/docs/src/content/docs/agentic-usage.md @@ -7,7 +7,9 @@ AI coding agents like Claude Code — and any agent that reads skills from `~/.a ## Automatic Installation -When you install the CLI (via `curl`, Homebrew, or a package manager), `sentry cli setup` automatically installs agent skills into any detected agent root directories (`~/.claude`, `~/.agents`). Skills are also refreshed on `sentry cli upgrade`. No network fetch is needed — skill files are embedded in the binary. +When you install the CLI via `curl` or Homebrew, `sentry cli setup` automatically installs agent skills into any detected agent root directories (`~/.claude`, `~/.agents`). Skills are also refreshed on `sentry cli upgrade`. No network fetch is needed — skill files are embedded in the binary. + +If you installed via a package manager (`npm`, `pnpm`, `bun`, `yarn`), run `sentry cli setup` once to install the skills — there is no automatic postinstall hook. To skip automatic skill installation, pass `--no-agent-skills` to `sentry cli setup`. From 80e423a9f1a5de9be9db008c7b94c032ea525b94 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Mon, 15 Jun 2026 12:12:54 +0000 Subject: [PATCH 3/6] docs: fix Node.js version requirement in library-usage.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The library usage page said >=22 but package.json engines require >=22.15. Updated both the Requirements section and the comparison table to match. Co-authored-by: Miguel Betegón --- docs/src/content/docs/library-usage.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/src/content/docs/library-usage.md b/docs/src/content/docs/library-usage.md index bee5978d7..502b99cbf 100644 --- a/docs/src/content/docs/library-usage.md +++ b/docs/src/content/docs/library-usage.md @@ -211,11 +211,11 @@ Calls should be sequential (awaited one at a time). | **Output** | Parsed object (zero-copy) | String (needs JSON.parse) | | **Errors** | `SentryError` with typed fields | Exit code + stderr string | | **Auth** | `token` option or env vars | Env vars only | -| **Node.js** | >=22 required | Any version | +| **Node.js** | >=22.15 required | Any version | ## Requirements -- **Node.js >= 22** (required for `node:sqlite`) +- **Node.js >= 22.15** (required for `node:sqlite`) ## Streaming Commands From e8ef7e87d2d0e2944937b3c815ffc6f4a6f475fe Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Mon, 15 Jun 2026 12:13:14 +0000 Subject: [PATCH 4/6] docs: add proguard upload examples to command fragment MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The proguard.md fragment only covered the uuid subcommand. Added examples for the upload subcommand including multi-file upload, UUID override, and validate-only modes. Co-authored-by: Miguel Betegón --- docs/src/fragments/commands/proguard.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/docs/src/fragments/commands/proguard.md b/docs/src/fragments/commands/proguard.md index 263a410aa..5ebea6de7 100644 --- a/docs/src/fragments/commands/proguard.md +++ b/docs/src/fragments/commands/proguard.md @@ -2,6 +2,24 @@ ## Examples +### Upload + +```bash +# Upload a ProGuard/R8 mapping file (org/project auto-detected) +sentry proguard upload ./app/build/outputs/mapping/release/mapping.txt + +# Upload multiple mapping files +sentry proguard upload mapping-app.txt mapping-lib.txt + +# Upload with a specific UUID (overrides the computed UUID) +sentry proguard upload --uuid abcdef01-2345-6789-abcd-ef0123456789 mapping.txt + +# Validate without uploading +sentry proguard upload --no-upload mapping.txt +``` + +### UUID + ```bash # Compute the UUID for a ProGuard/R8 mapping file sentry proguard uuid ./app/build/outputs/mapping/release/mapping.txt @@ -17,3 +35,5 @@ sentry proguard uuid mapping.txt --json Sentry uses to associate a mapping with obfuscated Android stack traces. - This matches the UUID computed by the legacy `sentry-cli proguard uuid` command byte-for-byte. +- Upload uses the Sentry chunk-upload protocol (DIF). Each mapping is + bundled as `proguard/.txt`. From e802155a68d0ed74a8bf920d4cfe37809eddb319 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Mon, 15 Jun 2026 12:13:32 +0000 Subject: [PATCH 5/6] docs: update plugins/README.md to show references/ directory MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The repository structure diagram omitted the references/ directories under both .cursor/skills/ and plugins/sentry-cli/skills/. These contain 26 per-command reference files. Also clarified that SKILL.md is a symlink while references/ are copies synced by CI. Co-authored-by: Miguel Betegón --- plugins/README.md | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/plugins/README.md b/plugins/README.md index ba62d5ed1..af6a6d014 100644 --- a/plugins/README.md +++ b/plugins/README.md @@ -61,7 +61,10 @@ cli/ # Repository root ├── .cursor/ │ └── skills/ │ └── sentry-cli/ -│ └── SKILL.md # Symlink to plugins location +│ ├── SKILL.md # Symlink → plugins/.../SKILL.md +│ └── references/ # Copies of per-command reference files +│ ├── issue.md +│ └── ... # One .md per visible route (26 total) ├── plugins/ │ ├── README.md # This file │ └── sentry-cli/ @@ -69,11 +72,16 @@ cli/ # Repository root │ │ └── plugin.json # Plugin manifest │ └── skills/ │ └── sentry-cli/ -│ └── SKILL.md # CLI usage skill (auto-generated) +│ ├── SKILL.md # CLI usage skill (auto-generated) +│ └── references/ # Per-command reference files (canonical) +│ ├── issue.md +│ └── ... └── script/ - └── generate-skill.ts # Generates SKILL.md from CLI commands + └── generate-skill.ts # Generates SKILL.md + references from CLI commands ``` +`SKILL.md` under `.cursor/skills/` is a symlink to the canonical `plugins/` location. The `references/` files are copies kept in sync by CI — the canonical source is `plugins/sentry-cli/skills/sentry-cli/references/`. + ## Updating SKILL.md The SKILL.md file is **auto-generated** from the CLI's command definitions. Do not edit it manually. From 2d4dc750e44c56efe528a780deb41262c99187db Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Mon, 15 Jun 2026 12:15:28 +0000 Subject: [PATCH 6/6] chore: regenerate docs --- .../skills/sentry-cli/references/proguard.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/plugins/sentry-cli/skills/sentry-cli/references/proguard.md b/plugins/sentry-cli/skills/sentry-cli/references/proguard.md index 65bc8103f..52e63472c 100644 --- a/plugins/sentry-cli/skills/sentry-cli/references/proguard.md +++ b/plugins/sentry-cli/skills/sentry-cli/references/proguard.md @@ -20,6 +20,22 @@ Upload ProGuard/R8 mapping files to Sentry - `--no-upload - Compute and print UUIDs without uploading (dry-run)` - `--require-one - Require at least one mapping file (error if none provided)` +**Examples:** + +```bash +# Upload a ProGuard/R8 mapping file (org/project auto-detected) +sentry proguard upload ./app/build/outputs/mapping/release/mapping.txt + +# Upload multiple mapping files +sentry proguard upload mapping-app.txt mapping-lib.txt + +# Upload with a specific UUID (overrides the computed UUID) +sentry proguard upload --uuid abcdef01-2345-6789-abcd-ef0123456789 mapping.txt + +# Validate without uploading +sentry proguard upload --no-upload mapping.txt +``` + ### `sentry proguard uuid ` Compute the UUID for a ProGuard mapping file