feat(config): support .sentryclirc config file for per-directory defaults

[BYK]

Summary

• Adds backward-compatible .sentryclirc INI config file support, matching the legacy sentry-cli format
• Walks up from CWD to find config files, merging them (closest file wins per-field) with ~/.sentryclirc as global fallback
• Enables per-directory org/project defaults for monorepos
• Token and URL are applied via env shim (SENTRY_AUTH_TOKEN, SENTRY_URL); org/project are inserted directly into the resolution chain with source tracking

Resolution chain (updated)

1. Explicit CLI args          (highest)
2. Environment variables
3. .sentryclirc file          ← NEW
4. SQLite defaults
5. DSN auto-detection
6. Directory name inference   (lowest)

Monorepo example

monorepo/
  .sentryclirc              # [defaults] org = my-company
  packages/
    frontend/.sentryclirc   # [defaults] project = frontend-web
    backend/.sentryclirc    # [defaults] project = backend-api

New files

File	Purpose
src/lib/ini.ts	Zero-dep INI parser (BOM, quotes, case-insensitive)
src/lib/sentryclirc.ts	Walk-up discovery + merge + env shim + cache
test/lib/ini.test.ts	26 unit tests
test/lib/ini.property.test.ts	6 property-based tests (fast-check)
test/lib/sentryclirc.test.ts	24 unit tests
test/lib/sentryclirc.property.test.ts	3 property-based tests

Modified files

• src/cli.ts — call applySentryCliRcEnvShim() early in boot
• src/lib/resolve-target.ts — insert step 3 in all 4 resolution functions
• docs/src/content/docs/configuration.md — new .sentryclirc section with monorepo guide
• docs/src/content/docs/features.md — link to resolution priority + tip
• docs/src/content/docs/agent-guidance.md — updated auto-detection references
• plugins/sentry-cli/skills/sentry-cli/SKILL.md — regenerated

[github-actions]

Semver Impact of This PR

🟡 Minor (new features)

📋 Changelog Preview

This is how your changes will appear in the changelog.
Entries from this PR are highlighted with a left border (blockquote style).

---

New Features ✨

• (commands) Add buildRouteMap wrapper with standard subcommand aliases by BYK in #690

• (config) Support .sentryclirc config file for per-directory defaults by BYK in #693

• (release) Surface adoption and health metrics in list and view (Add release command group with adoption/health subcommand #463) by BYK in #680

Bug Fixes 🐛

Dashboard

• Add --layout flag to widget add for predictable placement by BYK in #700
• Render tracemetrics widgets in dashboard view by BYK in #695

Other

• (init) Narrow command validation to actual shell injection vectors by betegon in #697
• (init,feedback) Default to tracing only in feature select and attach user email to feedback by MathurAditya724 in #688

Internal Changes 🔧

• (docs) Gitignore generated command docs, extract fragments by BYK in #696
• (eval) Replace OpenAI with Anthropic SDK in init-eval judge by betegon in #683
• (init) Use markdown pipeline for spinner messages by betegon in #686
• Regenerate skill files and command docs by github-actions[bot] in 584ec0e0

---

_{🤖 This preview updates automatically when you update the PR.}

[github-actions]

PR Preview Action v1.8.1
🚀 View preview at https://cli.sentry.dev/pr-preview/pr-693/
Built to branch gh-pages at 2026-04-09 13:19 UTC. Preview will be ready when the GitHub Pages deployment is complete.

[github-actions]

Codecov Results 📊

✅ 134 passed | Total: 134 | Pass Rate: 100% | Execution Time: 0ms

📊 Comparison with Base Branch

Metric	Change
Total Tests	—
Passed Tests	—
Failed Tests	—
Skipped Tests	—

✨ No test changes detected

All tests are passing successfully.

✅ Patch coverage is 88.74%. Project has 1546 uncovered lines.
❌ Project coverage is 95.32%. Comparing base (base) to head (head).

Files with missing lines (2)

File	Patch %	Lines
src/lib/resolve-target.ts	34.88%	⚠️ 28 Missing
src/lib/sentryclirc.ts	96.40%	⚠️ 5 Missing

Coverage diff

@@            Coverage Diff             @@
##          main       #PR       +/-##
==========================================
- Coverage    95.47%    95.32%    -0.15%
==========================================
  Files          224       228        +4
  Lines        32591     33037      +446
  Branches         0         0         —
==========================================
+ Hits         31115     31491      +376
- Misses        1476      1546       +70
- Partials         0         0         —

---

Generated by Codecov Action

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 3b880a9. Configure here.}