docs: add missing subcommand examples and flag documentation

- Add dashboard revisions/restore examples to dashboard.md fragment
- Add issue events subcommand and @latest/@most_frequent selectors to issue.md
- Add cli defaults and cli import examples to cli.md fragment
- Document auth login --url, --force, --timeout flags in auth.md
- Document install script flags and env vars in getting-started.mdx

Co-authored-by: Miguel Betegón <miguelbetegongarcia@gmail.com>

Author: cursoragent

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

@@ -36,6 +36,29 @@ The `--version` flag takes precedence over `SENTRY_VERSION` if both are set.
 The chosen channel is persisted so that `sentry cli upgrade` automatically
 tracks the same channel on future updates.
 
+#### Install Script Options
+
+The install script accepts these flags (passed after `--`):
+
+```bash
+# Skip PATH modification (e.g., in CI where PATH is managed externally)
+curl https://cli.sentry.dev/install -fsS | bash -s -- --no-modify-path
+
+# Skip shell completion installation
+curl https://cli.sentry.dev/install -fsS | bash -s -- --no-completions
+
+# Skip agent skill installation (for Claude Code, Cursor, etc.)
+curl https://cli.sentry.dev/install -fsS | bash -s -- --no-agent-skills
+```
+
+Environment variables:
+
+| Variable | Description |
+|----------|-------------|
+| `SENTRY_VERSION` | Pin version (e.g., `0.19.0`) or channel (`nightly`) |
+| `SENTRY_INSTALL_DIR` | Override binary install directory (default: `~/.sentry/bin`) |
+| `SENTRY_INIT` | Set to `1` to run `sentry init` after install |
+
 #### Supported Platforms
 
 {/* GENERATED:START platform-support */}

docs/src/fragments/commands/auth.md

@@ -22,17 +22,28 @@ sentry auth login --token YOUR_SENTRY_API_TOKEN
 
 ### Self-hosted Sentry
 
+The `--url` flag is required when first connecting to a self-hosted instance.
+This registers the host as trusted so subsequent commands don't need the flag:
+
 ```bash
-SENTRY_URL=https://sentry.example.com sentry auth login
+# OAuth login to a self-hosted instance (requires --url on first use)
+sentry auth login --url https://sentry.example.com
+
+# Token-based auth with self-hosted
+sentry auth login --token YOUR_TOKEN --url https://sentry.example.com
 ```
 
-For token-based auth with self-hosted:
+See [Self-Hosted Sentry](../self-hosted/) for details.
+
+### Re-authenticate and timeouts
 
 ```bash
-SENTRY_URL=https://sentry.example.com sentry auth login --token YOUR_TOKEN
-```
+# Force re-authentication (skip "already logged in" prompt)
+sentry auth login --force
 
-See [Self-Hosted Sentry](../self-hosted/) for details.
+# Set a custom timeout for the OAuth flow (default: 900 seconds)
+sentry auth login --timeout 300
+```
 
 ### Logout
 

docs/src/fragments/commands/cli.md

@@ -91,3 +91,49 @@ sentry cli setup --no-agent-skills
 # Skip PATH and completion modifications
 sentry cli setup --no-modify-path --no-completions
 ```
+
+### View and manage defaults
+
+```bash
+# Show all current defaults
+sentry cli defaults
+
+# Set default organization
+sentry cli defaults org my-org
+
+# Set default project
+sentry cli defaults project my-project
+
+# Set Sentry URL (self-hosted)
+sentry cli defaults url https://sentry.example.com
+
+# Disable telemetry
+sentry cli defaults telemetry off
+
+# Clear a specific default
+sentry cli defaults org --clear
+
+# Clear all defaults (with confirmation)
+sentry cli defaults --clear
+```
+
+See [Configuration](../configuration/#persistent-defaults) for more details on defaults.
+
+### Import settings from legacy `.sentryclirc`
+
+```bash
+# Scan for and import legacy .sentryclirc settings
+sentry cli import
+
+# Preview what would be imported
+sentry cli import --dry-run
+
+# Skip confirmation prompts
+sentry cli import --yes
+
+# Trust a specific self-hosted URL during import
+sentry cli import --url https://sentry.example.com
+
+# Skip API validation of the imported token
+sentry cli import --skip-validation
+```

docs/src/fragments/commands/dashboard.md

@@ -108,6 +108,29 @@ sentry dashboard widget delete 'My Dashboard' --title 'Error Count'
 sentry dashboard widget delete 12345 --index 2
 ```
 
+### View revision history
+
+```bash
+# List revisions for a dashboard
+sentry dashboard revisions 'Frontend Performance'
+
+# By dashboard ID
+sentry dashboard revisions 12345
+
+# Paginate through revision history
+sentry dashboard revisions 12345 -c next
+```
+
+### Restore a previous revision
+
+```bash
+# Restore a specific revision (use `revisions` to find the revision ID)
+sentry dashboard restore 'Frontend Performance' --revision 3
+
+# Restore by dashboard ID
+sentry dashboard restore 12345 --revision 1
+```
+
 ## Query Shorthand
 
 The `--query` flag supports shorthand for aggregate functions:

docs/src/fragments/commands/issue.md

@@ -79,6 +79,41 @@ Latest event:
 sentry issue view FRONT-ABC -w
 ```
 
+### List events for an issue
+
+```bash
+# List recent events for an issue
+sentry issue events FRONT-ABC
+
+# With search filter
+sentry issue events FRONT-ABC --query "browser:Chrome"
+
+# Include full event body with stacktraces
+sentry issue events FRONT-ABC --full
+
+# Limit and time range
+sentry issue events FRONT-ABC --limit 50 --period 24h
+
+# Paginate through events
+sentry issue events FRONT-ABC -c next
+```
+
+### Magic selectors
+
+Use `@latest` and `@most_frequent` to quickly access common issues without looking up IDs:
+
+```bash
+# View the most recently seen issue
+sentry issue view @latest
+
+# Explain the most frequently occurring issue
+sentry issue explain @most_frequent
+
+# Works with any issue subcommand
+sentry issue plan @latest
+sentry issue events @latest --limit 5
+```
+
 ### Explain and plan with Seer AI
 
 ```bash