Skip to content

Add optional Sentry error reporting (env-driven, opt-in) #2139

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
kevincodex1 merged 5 commits into from
Aug 19, 2026
Merged

Add optional Sentry error reporting (env-driven, opt-in) #2139

Show file tree
Hide file tree
Changes from 3 commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
3199e79
Add optional Sentry error reporting (env-driven, opt-in)
anushkadas-coder Aug 17, 2026
e7fec01
Fix Sentry init to use dynamic import instead of require (ESM compati…
anushkadas-coder Aug 17, 2026
dd4ba7d
Document SENTRY_DSN setup in advanced-setup docs
anushkadas-coder Aug 17, 2026
040f7f7
Disable Sentry default integrations; document runtime install require…
anushkadas-coder Aug 17, 2026
6454dec
Wire reportErrorToSentry into top-level error handlers; add sentry.te…
anushkadas-coder Aug 19, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
63 changes: 63 additions & 0 deletions bun.lock
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

22 changes: 22 additions & 0 deletions docs/advanced-setup.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -592,6 +592,28 @@ reject accidental absurd values. An invalid pricing map is ignored without
discarding unrelated settings from the same file. `/config` does not currently
edit record-valued settings, so edit the JSON file directly.

## Optional Error Reporting (Sentry)

OpenClaude can optionally report sanitized error events to Sentry. This is
disabled by default and opt-in only.

```bash
export SENTRY_DSN=https://your-key@your-org.ingest.sentry.io/your-project
openclaude
```

Notes:

- Reporting only activates when `SENTRY_DSN` is set. Unset, this is a no-op.
- Reporting is skipped even when `SENTRY_DSN` is set if `DISABLE_TELEMETRY` or
`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` is set, matching the same privacy
levels used for existing telemetry (see [Runtime Hardening](#runtime-hardening)).
- Only sanitized, telemetry-safe error messages are sent — never raw error
messages, which may contain file paths or other identifying information.
- `@sentry/node` is an optional dev dependency, loaded on demand via dynamic
import only when this feature is enabled. It is not part of the default
install.

Comment thread
coderabbitai[bot] marked this conversation as resolved.
Outdated
## Safety strictness

OpenClaude runs several "safety" checks: a model-level refusal directive, bash
Expand Down
1 change: 1 addition & 0 deletions package.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -85,6 +85,7 @@
"devDependencies": {
"@alcalzone/ansi-tokenize": "0.3.0",
"@anthropic-ai/bedrock-sdk": "0.29.1",
"@sentry/node": "^10.70.0",
"@anthropic-ai/foundry-sdk": "0.2.3",
"@anthropic-ai/sandbox-runtime": "0.0.55",
"@anthropic-ai/sdk": "0.94.0",
Expand Down
Loading