From 32ddb9ba3af1043aaead06fa8327d0ba34f1956c Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Mon, 21 Sep 2026 12:04:29 +0000 Subject: [PATCH 1/4] fix(docs): correct agent-conversation view positional syntax MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The fragment showed space-separated org and conversation ID (`sentry agent-conversation view my-org conv-123`) but the command accepts a single slash-separated positional (`my-org/conv-123`). Also added the no-org variant to show auto-detection. Co-authored-by: Miguel Betegón --- .../src/fragments/commands/agent-conversation.md | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/apps/cli-docs/src/fragments/commands/agent-conversation.md b/apps/cli-docs/src/fragments/commands/agent-conversation.md index ca9b2b2e3..9ae15932f 100644 --- a/apps/cli-docs/src/fragments/commands/agent-conversation.md +++ b/apps/cli-docs/src/fragments/commands/agent-conversation.md @@ -25,9 +25,12 @@ sentry agent-conversation list my-org -c next ### View a conversation transcript ```bash -# View full transcript -sentry agent-conversation view my-org conv-123 +# View full transcript (org auto-detected) +sentry agent-conversation view conv-123 + +# Explicit org (slash-separated) +sentry agent-conversation view my-org/conv-123 # JSON output -sentry agent-conversation view my-org conv-123 --json +sentry agent-conversation view my-org/conv-123 --json ``` From 6281672ce0c08d286292c8fbb519dea80b331d5f Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Mon, 21 Sep 2026 12:04:35 +0000 Subject: [PATCH 2/4] docs: add agent-conversation, wasm-split, and status to agentic docs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit New commands added since the last audit were missing from the agentic usage and agent guidance pages: - agent-conversation (list/view): browse AI agent conversation transcripts - wasm-split: add build IDs to WebAssembly modules (no auth, local-only) - status: check Sentry service status (no auth) Added capabilities entries, 'How It Works' example, and workflow patterns with bash examples. Co-authored-by: Miguel Betegón --- .../src/content/docs/agent-guidance.md | 29 +++++++++++++++++++ .../src/content/docs/agentic-usage.md | 4 +++ 2 files changed, 33 insertions(+) diff --git a/apps/cli-docs/src/content/docs/agent-guidance.md b/apps/cli-docs/src/content/docs/agent-guidance.md index d712ed921..05203ce21 100644 --- a/apps/cli-docs/src/content/docs/agent-guidance.md +++ b/apps/cli-docs/src/content/docs/agent-guidance.md @@ -198,6 +198,35 @@ sentry release deploy my-org/1.0.0 production - `--auto` requires a Sentry repository integration (GitHub/GitLab/Bitbucket) **and** a local git checkout. It matches your `origin` remote against Sentry's repo list. Without a checkout, use `--local`. - With no flag, `set-commits` tries `--auto` first and falls back to `--local` on failure. +### View Agent Conversations + +```bash +# List recent agent conversations (org auto-detected) +sentry agent-conversation list + +# Explicit org, last 24 hours +sentry agent-conversation list my-org --period 24h + +# View a conversation transcript +sentry agent-conversation view my-org/conv-123 + +# JSON output for programmatic access +sentry agent-conversation view conv-123 --json +``` + +### Process WebAssembly Modules + +```bash +# Add a build id to a wasm module (no auth required) +sentry wasm-split app.wasm + +# Capture the build id for a later debug-files upload +BUILD_ID=$(sentry wasm-split app.wasm) + +# Split debug data into a companion and strip the shipped binary +sentry wasm-split app.wasm --debug-out app.debug.wasm --strip +``` + ### Arbitrary API Access ```bash diff --git a/apps/cli-docs/src/content/docs/agentic-usage.md b/apps/cli-docs/src/content/docs/agentic-usage.md index 5ec3c85b6..81012bb0a 100644 --- a/apps/cli-docs/src/content/docs/agentic-usage.md +++ b/apps/cli-docs/src/content/docs/agentic-usage.md @@ -56,6 +56,9 @@ With this skill, agents can: - **Query documentation** - Ask questions about Sentry setup and configuration with `sentry docs` - **Make API calls** - Execute arbitrary Sentry API requests - **Authenticate** - Help you set up CLI authentication +- **View agent conversations** - List and inspect AI agent conversation transcripts with `sentry agent-conversation` +- **Check service status** - Query the Sentry status page with `sentry status` (no auth required) +- **Process WebAssembly** - Add build IDs and split debug data from wasm modules with `sentry wasm-split` (no auth required) ## How It Works @@ -67,6 +70,7 @@ When you ask your agent about Sentry errors or want to investigate an issue, the - "What API endpoints exist for releases?" → `sentry schema releases` - "How do I set up source maps for Next.js?" → `sentry docs "source maps Next.js"` - "What is Sentry's status right now?" → `sentry status` +- "Show me recent agent conversations" → `sentry agent-conversation list` The CLI has dedicated commands for most Sentry tasks, so agents should prefer `sentry` commands over constructing raw API calls. The `sentry docs` command queries Sentry's documentation directly from the terminal, the `sentry schema` command provides built-in API exploration, and `sentry api` handles authenticated requests for anything not covered by a dedicated command. From 7e342b05867ba76afec0417317a167911a31b8dd Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Mon, 21 Sep 2026 12:04:41 +0000 Subject: [PATCH 3/4] docs: update AGENTS.md command group list to match current source tree MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The Architecture section listed a subset of command groups with an ellipsis. Replaced with the full alphabetical list so new contributors find every group and standalone command file at a glance. Co-authored-by: Miguel Betegón --- packages/cli/AGENTS.md | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/packages/cli/AGENTS.md b/packages/cli/AGENTS.md index 8a2b147b2..7e46a48b4 100644 --- a/packages/cli/AGENTS.md +++ b/packages/cli/AGENTS.md @@ -113,10 +113,14 @@ Top-level layout: - **`src/bin.ts`** — entry point; **`src/app.ts`** — Stricli application setup; **`src/context.ts`** — dependency-injection context. -- **`src/commands/`** — one directory per command group (`auth`, `cli`, `dashboard`, - `event`, `issue`, `log`, `org`, `project`, `release`, `replay`, `repo`, `sourcemap`, - `span`, `team`, `trace`, `trial`, `local`, …) plus standalone command files - (`api.ts`, `explore.ts`, `help.ts`, `init.ts`, `schema.ts`). +- **`src/commands/`** — one directory per command group (`agent-conversation`, + `alert`, `auth`, `build`, `cli`, `code-mappings`, `dart-symbol-map`, + `dashboard`, `debug-files`, `docs`, `event`, `feedback`, `issue`, `local`, + `log`, `monitor`, `org`, `platform`, `proguard`, `project`, `react-native`, + `release`, `replay`, `repo`, `snapshots`, `sourcemap`, `span`, `status`, + `team`, `trace`, `trial`) plus standalone command files (`api.ts`, + `explore.ts`, `help.ts`, `info.ts`, `init.ts`, `schema.ts`, + `wasm-split.ts`). - **`src/lib/`** — shared utilities. Key subtrees: `api/` (domain API modules), `db/` (SQLite layer), `dsn/` (DSN detection, with per-language extractors under `dsn/languages/`), and `formatters/` (output formatting). See the file-locations From 240e83b62a2f7028cbadc15ff4d4af33b15edc34 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Mon, 21 Sep 2026 12:06:32 +0000 Subject: [PATCH 4/4] chore: regenerate docs --- .../sentry-cli/skills/sentry-cli/SKILL.md | 29 +++++++++++++++++++ .../references/agent-conversation.md | 9 ++++-- 2 files changed, 35 insertions(+), 3 deletions(-) diff --git a/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md index 9fb20ac1f..66c6161ba 100644 --- a/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md +++ b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md @@ -210,6 +210,35 @@ sentry release deploy my-org/1.0.0 production - `--auto` requires a Sentry repository integration (GitHub/GitLab/Bitbucket) **and** a local git checkout. It matches your `origin` remote against Sentry's repo list. Without a checkout, use `--local`. - With no flag, `set-commits` tries `--auto` first and falls back to `--local` on failure. +#### View Agent Conversations + +```bash +# List recent agent conversations (org auto-detected) +sentry agent-conversation list + +# Explicit org, last 24 hours +sentry agent-conversation list my-org --period 24h + +# View a conversation transcript +sentry agent-conversation view my-org/conv-123 + +# JSON output for programmatic access +sentry agent-conversation view conv-123 --json +``` + +#### Process WebAssembly Modules + +```bash +# Add a build id to a wasm module (no auth required) +sentry wasm-split app.wasm + +# Capture the build id for a later debug-files upload +BUILD_ID=$(sentry wasm-split app.wasm) + +# Split debug data into a companion and strip the shipped binary +sentry wasm-split app.wasm --debug-out app.debug.wasm --strip +``` + #### Arbitrary API Access ```bash diff --git a/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md b/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md index cf5fe8217..dd6ffe1d6 100644 --- a/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md +++ b/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md @@ -74,11 +74,14 @@ View an agent conversation transcript **Examples:** ```bash -# View full transcript -sentry agent-conversation view my-org conv-123 +# View full transcript (org auto-detected) +sentry agent-conversation view conv-123 + +# Explicit org (slash-separated) +sentry agent-conversation view my-org/conv-123 # JSON output -sentry agent-conversation view my-org conv-123 --json +sentry agent-conversation view my-org/conv-123 --json ``` All commands also support `--json`, `--fields`, `--help`, `--log-level`, and `--verbose` flags.