Deploy preview for PR 685 🛫

Author: BYK

pr-preview/pr-685/.well-known/skills/sentry-cli/SKILL.md

@@ -22,7 +22,7 @@ Best practices and operational guidance for AI coding agents using the Sentry CL
 - **Use `sentry schema` to explore the API** — if you need to discover API endpoints, run `sentry schema` to browse interactively or `sentry schema <resource>` to search. This is faster than fetching OpenAPI specs externally.
 - **Use `sentry issue view <id>` to investigate issues** — when asked about a specific issue (e.g., `CLI-G5`, `PROJECT-123`), use `sentry issue view` directly.
 - **Use `--json` for machine-readable output** — pipe through `jq` for filtering. Human-readable output includes formatting that is hard to parse.
-- **The CLI auto-detects org/project** — most commands work without explicit targets by scanning for DSNs in `.env` files, source code, config defaults, and directory names. Only specify `<org>/<project>` when the CLI reports it can't detect the target or detects the wrong one.
+- **The CLI auto-detects org/project** — most commands work without explicit targets by checking `.sentryclirc` config files, scanning for DSNs in `.env` files and source code, and matching directory names. Only specify `<org>/<project>` when the CLI reports it can't detect the target or detects the wrong one.
 
 ### Design Principles
 
@@ -223,7 +223,7 @@ When querying the Events API (directly or via `sentry api`), valid dataset value
 - **Wrong issue ID format**: Use `PROJECT-123` (short ID), not the numeric ID `123456789`. The short ID includes the project prefix.
 - **Pre-authenticating unnecessarily**: Don't run `sentry auth login` before every command. The CLI detects missing/expired auth and prompts automatically. Only run `sentry auth login` if you need to switch accounts.
 - **Missing `--json` for piping**: Human-readable output includes formatting. Use `--json` when parsing output programmatically.
-- **Specifying org/project when not needed**: Auto-detection resolves org/project from DSNs, env vars, config defaults, and directory names. Let it work first — only add `<org>/<project>` if the CLI says it can't detect the target or detects the wrong one.
+- **Specifying org/project when not needed**: Auto-detection resolves org/project from `.sentryclirc` config files, DSNs, env vars, and directory names. Let it work first — only add `<org>/<project>` if the CLI says it can't detect the target or detects the wrong one.
 - **Confusing `--query` syntax**: The `--query` flag uses Sentry search syntax (e.g., `is:unresolved`, `assigned:me`), not free text search.
 - **Not using `--web`**: View commands support `-w`/`--web` to open the resource in the browser — useful for sharing links.
 - **Fetching API schemas instead of using the CLI**: Prefer `sentry schema` to browse the API and `sentry api` to make requests — the CLI handles authentication and endpoint resolution, so there's rarely a need to download OpenAPI specs separately.
@@ -346,8 +346,8 @@ Manage Sentry dashboards
 
 Work with Sentry releases
 
-- `sentry release list <org/project>` — List releases
-- `sentry release view <org/version...>` — View release details
+- `sentry release list <org/project>` — List releases with adoption and health metrics
+- `sentry release view <org/version...>` — View release details with health metrics
 - `sentry release create <org/version...>` — Create a release
 - `sentry release finalize <org/version...>` — Finalize a release
 - `sentry release delete <org/version...>` — Delete a release

pr-preview/pr-685/.well-known/skills/sentry-cli/references/dashboard.md

@@ -42,7 +42,7 @@ View a dashboard
 - `-w, --web - Open in browser`
 - `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data`
 - `-r, --refresh <value> - Auto-refresh interval in seconds (default: 60, min: 10)`
-- `-t, --period <value> - Time range: "7d", "2026-03-08..2026-04-08", ">=2026-03-08"`
+- `-t, --period <value> - Time range: "7d", "2026-03-01..2026-04-01", ">=2026-03-01"`
 
 **Examples:**
 
@@ -86,6 +86,7 @@ Add a widget to a dashboard
 - `--y <value> - Grid row position (0-based)`
 - `--width <value> - Widget width in grid columns (1–6)`
 - `--height <value> - Widget height in grid rows (min 1)`
+- `-l, --layout <value> - Layout mode: sequential (append in order) or dense (fill gaps) - (default: "sequential")`
 
 **Examples:**
 

pr-preview/pr-685/.well-known/skills/sentry-cli/references/event.md

@@ -28,7 +28,7 @@ List events for an issue
 - `-n, --limit <value> - Number of events (1-1000) - (default: "25")`
 - `-q, --query <value> - Search query (Sentry search syntax)`
 - `--full - Include full event body (stacktraces)`
-- `-t, --period <value> - Time range: "7d", "2026-03-08..2026-04-08", ">=2026-03-08" - (default: "7d")`
+- `-t, --period <value> - Time range: "7d", "2026-03-01..2026-04-01", ">=2026-03-01" - (default: "7d")`
 - `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data`
 - `-c, --cursor <value> - Navigate pages: "next", "prev", "first" (or raw cursor string)`
 

pr-preview/pr-685/.well-known/skills/sentry-cli/references/issue.md

@@ -19,7 +19,7 @@ List issues in a project
 - `-q, --query <value> - Search query (Sentry search syntax)`
 - `-n, --limit <value> - Maximum number of issues to list - (default: "25")`
 - `-s, --sort <value> - Sort by: date, new, freq, user - (default: "date")`
-- `-t, --period <value> - Time range: "7d", "2026-03-08..2026-04-08", ">=2026-03-08" - (default: "90d")`
+- `-t, --period <value> - Time range: "7d", "2026-03-01..2026-04-01", ">=2026-03-01" - (default: "90d")`
 - `-c, --cursor <value> - Pagination cursor (use "next" for next page, "prev" for previous)`
 - `--compact - Single-line rows for compact output (auto-detects if omitted)`
 - `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data`
@@ -78,7 +78,7 @@ List events for a specific issue
 - `-n, --limit <value> - Number of events (1-1000) - (default: "25")`
 - `-q, --query <value> - Search query (Sentry search syntax)`
 - `--full - Include full event body (stacktraces)`
-- `-t, --period <value> - Time range: "7d", "2026-03-08..2026-04-08", ">=2026-03-08" - (default: "7d")`
+- `-t, --period <value> - Time range: "7d", "2026-03-01..2026-04-01", ">=2026-03-01" - (default: "7d")`
 - `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data`
 - `-c, --cursor <value> - Navigate pages: "next", "prev", "first" (or raw cursor string)`
 

pr-preview/pr-685/.well-known/skills/sentry-cli/references/log.md

@@ -19,7 +19,7 @@ List logs from a project
 - `-n, --limit <value> - Number of log entries (1-1000) - (default: "100")`
 - `-q, --query <value> - Filter query (Sentry search syntax)`
 - `-f, --follow <value> - Stream logs (optionally specify poll interval in seconds)`
-- `-t, --period <value> - Time range: "7d", "2026-03-08..2026-04-08", ">=2026-03-08"`
+- `-t, --period <value> - Time range: "7d", "2026-03-01..2026-04-01", ">=2026-03-01"`
 - `-s, --sort <value> - Sort order: "newest" (default) or "oldest" - (default: "newest")`
 - `--fresh - Bypass cache, re-detect projects, and fetch fresh data`
 

pr-preview/pr-685/.well-known/skills/sentry-cli/references/release.md

@@ -13,16 +13,20 @@ Work with Sentry releases
 
 ### `sentry release list <org/project>`
 
-List releases
+List releases with adoption and health metrics
 
 **Flags:**
 - `-n, --limit <value> - Maximum number of releases to list - (default: "25")`
+- `-s, --sort <value> - Sort: date, sessions, users, crash_free_sessions (cfs), crash_free_users (cfu) - (default: "date")`
+- `-e, --environment <value>... - Filter by environment (repeatable, comma-separated)`
+- `-t, --period <value> - Health stats period (e.g., 24h, 7d, 14d, 90d) - (default: "90d")`
+- `--status <value> - Filter by status: open (default) or archived - (default: "open")`
 - `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data`
 - `-c, --cursor <value> - Navigate pages: "next", "prev", "first" (or raw cursor string)`
 
 ### `sentry release view <org/version...>`
 
-View release details
+View release details with health metrics
 
 **Flags:**
 - `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data`

pr-preview/pr-685/.well-known/skills/sentry-cli/references/span.md

@@ -19,7 +19,7 @@ List spans in a project or trace
 - `-n, --limit <value> - Number of spans (<=1000) - (default: "25")`
 - `-q, --query <value> - Filter spans (e.g., "op:db", "duration:>100ms", "project:backend")`
 - `-s, --sort <value> - Sort order: date, duration - (default: "date")`
-- `-t, --period <value> - Time range: "7d", "2026-03-08..2026-04-08", ">=2026-03-08" - (default: "7d")`
+- `-t, --period <value> - Time range: "7d", "2026-03-01..2026-04-01", ">=2026-03-01" - (default: "7d")`
 - `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data`
 - `-c, --cursor <value> - Navigate pages: "next", "prev", "first" (or raw cursor string)`
 

pr-preview/pr-685/.well-known/skills/sentry-cli/references/trace.md

@@ -19,7 +19,7 @@ List recent traces in a project
 - `-n, --limit <value> - Number of traces (1-1000) - (default: "25")`
 - `-q, --query <value> - Search query (Sentry search syntax)`
 - `-s, --sort <value> - Sort by: date, duration - (default: "date")`
-- `-t, --period <value> - Time range: "7d", "2026-03-08..2026-04-08", ">=2026-03-08" - (default: "7d")`
+- `-t, --period <value> - Time range: "7d", "2026-03-01..2026-04-01", ">=2026-03-01" - (default: "7d")`
 - `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data`
 - `-c, --cursor <value> - Navigate pages: "next", "prev", "first" (or raw cursor string)`
 
@@ -78,7 +78,7 @@ View logs associated with a trace
 
 **Flags:**
 - `-w, --web - Open trace in browser`
-- `-t, --period <value> - Time range: "7d", "2026-03-08..2026-04-08", ">=2026-03-08" - (default: "14d")`
+- `-t, --period <value> - Time range: "7d", "2026-03-01..2026-04-01", ">=2026-03-01" - (default: "14d")`
 - `-n, --limit <value> - Number of log entries (<=1000) - (default: "100")`
 - `-q, --query <value> - Additional filter query (Sentry search syntax)`
 - `-s, --sort <value> - Sort order: "newest" (default) or "oldest" - (default: "newest")`

pr-preview/pr-685/agent-guidance/index.html

@@ -159,7 +159,7 @@ <h2 id="key-principles">Key Principles</h2>
 <li><strong>Use <code dir="auto">sentry schema</code> to explore the API</strong> — if you need to discover API endpoints, run <code dir="auto">sentry schema</code> to browse interactively or <code dir="auto">sentry schema &#x3C;resource></code> to search. This is faster than fetching OpenAPI specs externally.</li>
 <li><strong>Use <code dir="auto">sentry issue view &#x3C;id></code> to investigate issues</strong> — when asked about a specific issue (e.g., <code dir="auto">CLI-G5</code>, <code dir="auto">PROJECT-123</code>), use <code dir="auto">sentry issue view</code> directly.</li>
 <li><strong>Use <code dir="auto">--json</code> for machine-readable output</strong> — pipe through <code dir="auto">jq</code> for filtering. Human-readable output includes formatting that is hard to parse.</li>
-<li><strong>The CLI auto-detects org/project</strong> — most commands work without explicit targets by scanning for DSNs in <code dir="auto">.env</code> files, source code, config defaults, and directory names. Only specify <code dir="auto">&#x3C;org>/&#x3C;project></code> when the CLI reports it can't detect the target or detects the wrong one.</li>
+<li><strong>The CLI auto-detects org/project</strong> — most commands work without explicit targets by checking <code dir="auto">.sentryclirc</code> config files, scanning for DSNs in <code dir="auto">.env</code> files and source code, and matching directory names. Only specify <code dir="auto">&#x3C;org>/&#x3C;project></code> when the CLI reports it can't detect the target or detects the wrong one.</li>
 </ul>
 <h2 id="design-principles">Design Principles</h2>
 <p>The <code dir="auto">sentry</code> CLI follows conventions from well-known tools — if you're familiar with them, that knowledge transfers directly:</p>
@@ -353,7 +353,7 @@ <h2 id="common-mistakes">Common Mistakes</h2>
 <li><strong>Wrong issue ID format</strong>: Use <code dir="auto">PROJECT-123</code> (short ID), not the numeric ID <code dir="auto">123456789</code>. The short ID includes the project prefix.</li>
 <li><strong>Pre-authenticating unnecessarily</strong>: Don't run <code dir="auto">sentry auth login</code> before every command. The CLI detects missing/expired auth and prompts automatically. Only run <code dir="auto">sentry auth login</code> if you need to switch accounts.</li>
 <li><strong>Missing <code dir="auto">--json</code> for piping</strong>: Human-readable output includes formatting. Use <code dir="auto">--json</code> when parsing output programmatically.</li>
-<li><strong>Specifying org/project when not needed</strong>: Auto-detection resolves org/project from DSNs, env vars, config defaults, and directory names. Let it work first — only add <code dir="auto">&#x3C;org>/&#x3C;project></code> if the CLI says it can't detect the target or detects the wrong one.</li>
+<li><strong>Specifying org/project when not needed</strong>: Auto-detection resolves org/project from <code dir="auto">.sentryclirc</code> config files, DSNs, env vars, and directory names. Let it work first — only add <code dir="auto">&#x3C;org>/&#x3C;project></code> if the CLI says it can't detect the target or detects the wrong one.</li>
 <li><strong>Confusing <code dir="auto">--query</code> syntax</strong>: The <code dir="auto">--query</code> flag uses Sentry search syntax (e.g., <code dir="auto">is:unresolved</code>, <code dir="auto">assigned:me</code>), not free text search.</li>
 <li><strong>Not using <code dir="auto">--web</code></strong>: View commands support <code dir="auto">-w</code>/<code dir="auto">--web</code> to open the resource in the browser — useful for sharing links.</li>
 <li><strong>Fetching API schemas instead of using the CLI</strong>: Prefer <code dir="auto">sentry schema</code> to browse the API and <code dir="auto">sentry api</code> to make requests — the CLI handles authentication and endpoint resolution, so there's rarely a need to download OpenAPI specs separately.</li>

pr-preview/pr-685/commands/dashboard/index.html

@@ -240,7 +240,7 @@ <h3 id="sentry-dashboard-view-orgprojectdashboard"><code dir="auto">sentry dashb
 
 
 
-<table><thead><tr><th>Option</th><th>Description</th></tr></thead><tbody><tr><td><code dir="auto">-w, --web</code></td><td>Open in browser</td></tr><tr><td><code dir="auto">-f, --fresh</code></td><td>Bypass cache, re-detect projects, and fetch fresh data</td></tr><tr><td><code dir="auto">-r, --refresh &#x3C;refresh></code></td><td>Auto-refresh interval in seconds (default: 60, min: 10)</td></tr><tr><td><code dir="auto">-t, --period &#x3C;period></code></td><td>Time range: "7d", "2026-03-08..2026-04-08", ">=2026-03-08"</td></tr></tbody></table>
+<table><thead><tr><th>Option</th><th>Description</th></tr></thead><tbody><tr><td><code dir="auto">-w, --web</code></td><td>Open in browser</td></tr><tr><td><code dir="auto">-f, --fresh</code></td><td>Bypass cache, re-detect projects, and fetch fresh data</td></tr><tr><td><code dir="auto">-r, --refresh &#x3C;refresh></code></td><td>Auto-refresh interval in seconds (default: 60, min: 10)</td></tr><tr><td><code dir="auto">-t, --period &#x3C;period></code></td><td>Time range: "7d", "2026-03-01..2026-04-01", ">=2026-03-01"</td></tr></tbody></table>
 <h3 id="sentry-dashboard-create-orgprojecttitle"><code dir="auto">sentry dashboard create &#x3C;org/project/title...></code></h3>
 <p>Create a dashboard</p>
 <p><strong>Arguments:</strong></p>
@@ -329,7 +329,11 @@ <h3 id="sentry-dashboard-widget-add-orgprojectdashboardtitle"><code dir="auto">s
 
 
 
-<table><thead><tr><th>Option</th><th>Description</th></tr></thead><tbody><tr><td><code dir="auto">-d, --display &#x3C;display></code></td><td>Display type (big_number, line, area, bar, table, stacked_area, top_n, text, categorical_bar, details, wheel, rage_and_dead_clicks, server_tree, agents_traces_table)</td></tr><tr><td><code dir="auto">--dataset &#x3C;dataset></code></td><td>Widget dataset (default: spans)</td></tr><tr><td><code dir="auto">-q, --query &#x3C;query>...</code></td><td>Aggregate expression (e.g. count, p95:span.duration)</td></tr><tr><td><code dir="auto">-w, --where &#x3C;where></code></td><td>Search conditions filter (e.g. is:unresolved)</td></tr><tr><td><code dir="auto">-g, --group-by &#x3C;group-by>...</code></td><td>Group-by column (repeatable)</td></tr><tr><td><code dir="auto">-s, --sort &#x3C;sort></code></td><td>Order by (prefix - for desc, e.g. -count)</td></tr><tr><td><code dir="auto">-n, --limit &#x3C;limit></code></td><td>Result limit</td></tr><tr><td><code dir="auto">--x &#x3C;x></code></td><td>Grid column position (0-based, 0–5)</td></tr><tr><td><code dir="auto">--y &#x3C;y></code></td><td>Grid row position (0-based)</td></tr><tr><td><code dir="auto">--width &#x3C;width></code></td><td>Widget width in grid columns (1–6)</td></tr><tr><td><code dir="auto">--height &#x3C;height></code></td><td>Widget height in grid rows (min 1)</td></tr></tbody></table>
+
+
+
+
+<table><thead><tr><th>Option</th><th>Description</th></tr></thead><tbody><tr><td><code dir="auto">-d, --display &#x3C;display></code></td><td>Display type (big_number, line, area, bar, table, stacked_area, top_n, text, categorical_bar, details, wheel, rage_and_dead_clicks, server_tree, agents_traces_table)</td></tr><tr><td><code dir="auto">--dataset &#x3C;dataset></code></td><td>Widget dataset (default: spans)</td></tr><tr><td><code dir="auto">-q, --query &#x3C;query>...</code></td><td>Aggregate expression (e.g. count, p95:span.duration)</td></tr><tr><td><code dir="auto">-w, --where &#x3C;where></code></td><td>Search conditions filter (e.g. is:unresolved)</td></tr><tr><td><code dir="auto">-g, --group-by &#x3C;group-by>...</code></td><td>Group-by column (repeatable)</td></tr><tr><td><code dir="auto">-s, --sort &#x3C;sort></code></td><td>Order by (prefix - for desc, e.g. -count)</td></tr><tr><td><code dir="auto">-n, --limit &#x3C;limit></code></td><td>Result limit</td></tr><tr><td><code dir="auto">--x &#x3C;x></code></td><td>Grid column position (0-based, 0–5)</td></tr><tr><td><code dir="auto">--y &#x3C;y></code></td><td>Grid row position (0-based)</td></tr><tr><td><code dir="auto">--width &#x3C;width></code></td><td>Widget width in grid columns (1–6)</td></tr><tr><td><code dir="auto">--height &#x3C;height></code></td><td>Widget height in grid rows (min 1)</td></tr><tr><td><code dir="auto">-l, --layout &#x3C;layout></code></td><td>Layout mode: sequential (append in order) or dense (fill gaps) (default: "sequential")</td></tr></tbody></table>
 <h3 id="sentry-dashboard-widget-edit-orgprojectdashboard"><code dir="auto">sentry dashboard widget edit &#x3C;org/project/dashboard...></code></h3>
 <p>Edit a widget in a dashboard</p>
 <p><strong>Arguments:</strong></p>