docs: documentation audit — fix version claims, license, agent coverage, and auth examples

.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?

apps/cli-docs/src/content/docs/agentic-usage.md

@@ -3,7 +3,7 @@ title: Agentic Usage
 description: Enable AI coding agents to use the Sentry CLI
 ---
 
-AI coding agents like Claude Code — and any agent that reads skills from `~/.agents` (such as Cursor) — can use the Sentry CLI through the skill system. This allows agents to interact with Sentry directly from your development environment.
+AI coding agents can use the Sentry CLI through the skill system. The CLI detects and supports Claude Code, Cursor, Windsurf, GitHub Copilot, Gemini CLI, OpenAI Codex, Goose, Amp, Augment, OpenCode, and any agent that reads skills from `~/.agents`. This allows agents to interact with Sentry directly from your development environment.
 
 ## Automatic Installation
 
@@ -49,4 +49,4 @@ The skill uses your existing CLI authentication, so you'll need to run `sentry a
 ## Requirements
 
 - An authenticated Sentry CLI installation (`sentry auth login`)
-- An AI coding agent that supports the skills system (e.g., Claude Code, or any agent that reads from `~/.agents` such as Cursor)
+- An AI coding agent that supports the skills system (e.g., Claude Code, Cursor, Windsurf, GitHub Copilot, Gemini CLI, Codex, Goose, Amp, Augment, OpenCode, or any agent that reads from `~/.agents`)

apps/cli-docs/src/content/docs/getting-started.mdx

@@ -24,7 +24,7 @@ which is especially useful in CI/CD pipelines and Dockerfiles:
 
 ```bash
 # Pin to a specific stable version
-SENTRY_VERSION=0.19.0 curl https://cli.sentry.dev/install -fsS | bash
+SENTRY_VERSION=0.40.0 curl https://cli.sentry.dev/install -fsS | bash
 
 # Pin to nightly
 SENTRY_VERSION=nightly curl https://cli.sentry.dev/install -fsS | bash
@@ -75,7 +75,7 @@ brew install getsentry/tools/sentry
 
 ## Package Managers
 
-Install globally with your preferred package manager (the npm/pnpm/yarn packages require **Node.js 22.15+**):
+Install globally with your preferred package manager (the npm packages require **Node.js 20+**; on **22.15+** the built-in `node:sqlite` is used, on 20–22.14 a bundled WASM fallback is used transparently):
 
 <PackageManagerCode
   npm="npm install -g sentry"

apps/cli-docs/src/fragments/commands/auth.md

@@ -21,16 +21,37 @@ sentry auth login
 sentry auth login --token YOUR_SENTRY_API_TOKEN
 ```
 
+### Read-only OAuth login
+
+Request only read-only scopes — useful for tokens handed to AI agents or
+CI jobs that should not mutate Sentry state:
+
+```bash
+sentry auth login --read-only
+```
+
+### Custom OAuth scopes
+
+Request specific scopes (repeatable, comma-separated):
+
+```bash
+sentry auth login --scope project:read --scope org:read
+sentry auth login --scope project:read,event:read
+```
+
 ### Self-hosted Sentry
 
+Use `--url` (recommended) or the `SENTRY_URL` environment variable:
+
 ```bash
+sentry auth login --url https://sentry.example.com
 SENTRY_URL=https://sentry.example.com sentry auth login
 ```
 
 For token-based auth with self-hosted:
 
 ```bash
-SENTRY_URL=https://sentry.example.com sentry auth login --token YOUR_TOKEN
+sentry auth login --token YOUR_TOKEN --url https://sentry.example.com
 ```
 
 See [Self-Hosted Sentry](../self-hosted/) for details.