Deploy preview for PR 966 🛫

Author: BYK

_preview/pr-966/.well-known/skills/index.json

@@ -0,0 +1,31 @@
+{
+  "skills": [
+    {
+      "name": "sentry-cli",
+      "description": "Guide for using the Sentry CLI to interact with Sentry from the command line. Use when the user asks about viewing issues, events, projects, organizations, making API calls, or authenticating with Sentry via CLI.",
+      "files": [
+        "SKILL.md",
+        "references/api.md",
+        "references/auth.md",
+        "references/cli.md",
+        "references/dashboard.md",
+        "references/event.md",
+        "references/explore.md",
+        "references/init.md",
+        "references/issue.md",
+        "references/log.md",
+        "references/org.md",
+        "references/project.md",
+        "references/release.md",
+        "references/replay.md",
+        "references/repo.md",
+        "references/schema.md",
+        "references/sourcemap.md",
+        "references/span.md",
+        "references/team.md",
+        "references/trace.md",
+        "references/trial.md"
+      ]
+    }
+  ]
+}

_preview/pr-966/.well-known/skills/sentry-cli/SKILL.md

@@ -0,0 +1,69 @@
+---
+name: sentry-cli-api
+version: 0.34.0-dev.0
+description: Make an authenticated API request
+requires:
+  bins: ["sentry"]
+  auth: true
+---
+
+# API Commands
+
+Make an authenticated API request
+
+### `sentry api <endpoint>`
+
+Make an authenticated API request
+
+**Flags:**
+- `-X, --method <value> - The HTTP method for the request - (default: "GET")`
+- `-d, --data <value> - Inline JSON body for the request (like curl -d)`
+- `-F, --field <value>... - Add a typed parameter (key=value, key[sub]=value, key[]=value)`
+- `-f, --raw-field <value>... - Add a string parameter without JSON parsing`
+- `-H, --header <value>... - Add a HTTP request header in key:value format`
+- `--input <value> - The file to use as body for the HTTP request (use "-" to read from standard input)`
+- `--silent - Do not print the response body`
+- `--verbose - Include full HTTP request and response in the output`
+- `-n, --dry-run - Show the resolved request without sending it`
+
+**Examples:**
+
+```bash
+# List organizations
+sentry api organizations/
+
+# Get a specific issue
+sentry api issues/123456789/
+
+# Create a release
+sentry api organizations/my-org/releases/ \
+  -X POST -F version=1.0.0
+
+# With inline JSON body
+sentry api issues/123456789/ \
+  -X POST -d '{"status": "resolved"}'
+
+# Update an issue status
+sentry api issues/123456789/ \
+  -X PUT -F status=resolved
+
+# Assign an issue
+sentry api issues/123456789/ \
+  -X PUT --field assignedTo="user@example.com"
+
+sentry api projects/my-org/my-project/ -X DELETE
+
+# Add custom headers
+sentry api organizations/ -H "X-Custom: value"
+
+# Read body from a file
+sentry api projects/my-org/my-project/releases/ -X POST --input release.json
+
+# Verbose mode (shows full HTTP request/response)
+sentry api organizations/ --verbose
+
+# Preview the request without sending
+sentry api organizations/ --dry-run
+```
+
+All commands also support `--json`, `--fields`, `--help`, `--log-level`, and `--verbose` flags.

_preview/pr-966/.well-known/skills/sentry-cli/references/api.md

@@ -0,0 +1,96 @@
+---
+name: sentry-cli-auth
+version: 0.34.0-dev.0
+description: Authenticate with Sentry
+requires:
+  bins: ["sentry"]
+  auth: true
+---
+
+# Auth Commands
+
+Authenticate with Sentry
+
+### `sentry auth login`
+
+Authenticate with Sentry
+
+**Flags:**
+- `--token <value> - Authenticate using an API token instead of OAuth`
+- `--timeout <value> - Timeout for OAuth flow in seconds (default: 900) - (default: "900")`
+- `--force - Re-authenticate without prompting`
+- `--url <value> - Sentry instance URL to authenticate against (e.g. https://sentry.example.com). Required for self-hosted; defaults to SaaS (https://sentry.io).`
+
+**Examples:**
+
+```bash
+sentry auth login
+
+sentry auth login --token YOUR_SENTRY_API_TOKEN
+
+SENTRY_URL=https://sentry.example.com sentry auth login
+
+SENTRY_URL=https://sentry.example.com sentry auth login --token YOUR_TOKEN
+```
+
+### `sentry auth logout`
+
+Log out of Sentry
+
+**Examples:**
+
+```bash
+sentry auth logout
+```
+
+### `sentry auth refresh`
+
+Refresh your authentication token
+
+**Flags:**
+- `--force - Force refresh even if token is still valid`
+
+**Examples:**
+
+```bash
+sentry auth refresh
+```
+
+### `sentry auth status`
+
+View authentication status
+
+**Flags:**
+- `--show-token - Show the stored token (masked by default)`
+- `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data`
+
+**Examples:**
+
+```bash
+sentry auth status
+
+# Show the raw token
+sentry auth status --show-token
+
+# View current user
+sentry auth whoami
+```
+
+### `sentry auth token`
+
+Print the stored authentication token
+
+**Examples:**
+
+```bash
+sentry auth token
+```
+
+### `sentry auth whoami`
+
+Show the currently authenticated identity
+
+**Flags:**
+- `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data`
+
+All commands also support `--json`, `--fields`, `--help`, `--log-level`, and `--verbose` flags.

_preview/pr-966/.well-known/skills/sentry-cli/references/auth.md

@@ -0,0 +1,107 @@
+---
+name: sentry-cli-cli
+version: 0.34.0-dev.0
+description: CLI-related commands
+requires:
+  bins: ["sentry"]
+  auth: true
+---
+
+# CLI Commands
+
+CLI-related commands
+
+### `sentry cli defaults <key value...>`
+
+View and manage default settings
+
+**Flags:**
+- `--clear - Clear the specified default, or all defaults if no key is given`
+- `-y, --yes - Skip confirmation prompt`
+- `-f, --force - Force the operation without confirmation`
+
+### `sentry cli feedback <message...>`
+
+Send feedback about the CLI
+
+**Examples:**
+
+```bash
+# Send positive feedback
+sentry cli feedback i love this tool
+
+# Report an issue
+sentry cli feedback the issue view is confusing
+```
+
+### `sentry cli fix`
+
+Diagnose and repair CLI database issues
+
+**Flags:**
+- `--dry-run - Show what would be fixed without making changes`
+
+**Examples:**
+
+```bash
+sentry cli fix
+```
+
+### `sentry cli setup`
+
+Configure shell integration
+
+**Flags:**
+- `--install - Install the binary from a temp location to the system path`
+- `--method <value> - Installation method (curl, npm, pnpm, bun, yarn)`
+- `--channel <value> - Release channel to persist (stable or nightly)`
+- `--no-modify-path - Skip PATH modification`
+- `--no-completions - Skip shell completion installation`
+- `--no-agent-skills - Skip agent skill installation for AI coding assistants`
+- `--quiet - Suppress output (for scripted usage)`
+
+**Examples:**
+
+```bash
+# Run full setup (PATH, completions, agent skills)
+sentry cli setup
+
+# Skip agent skill installation
+sentry cli setup --no-agent-skills
+
+# Skip PATH and completion modifications
+sentry cli setup --no-modify-path --no-completions
+```
+
+### `sentry cli upgrade <version>`
+
+Update the Sentry CLI to the latest version
+
+**Flags:**
+- `--check - Check for updates without installing`
+- `--force - Force upgrade even if already on the latest version`
+- `--offline - Upgrade using only cached version info and patches (no network)`
+- `--method <value> - Installation method to use (curl, brew, npm, pnpm, bun, yarn)`
+
+**Examples:**
+
+```bash
+sentry cli upgrade --check
+
+# Upgrade to latest stable
+sentry cli upgrade
+
+# Upgrade to a specific version
+sentry cli upgrade 0.5.0
+
+# Force re-download
+sentry cli upgrade --force
+
+# Switch to nightly builds
+sentry cli upgrade nightly
+
+# Switch back to stable
+sentry cli upgrade stable
+```
+
+All commands also support `--json`, `--fields`, `--help`, `--log-level`, and `--verbose` flags.