Skip to main content
← Back to list
01Issue
FeatureShippedSwamp Club
Assigneesstack72

Relationships

#1129 Docs: document user-global telemetry (telemetry.yaml opt-out, spool location, telemetry stats behavior)

Opened by keeb · 7/14/2026· Shipped 7/18/2026

Follow-up to #1125 (telemetry is now user-global). The manual under content/manual/reference/ doesn't yet cover the new behavior:

  • Spool location: telemetry now lives at $XDG_CONFIG_HOME/swamp/telemetry (default ~/.config/swamp/telemetry), not repo-local .swamp/telemetry. 'swamp repo init' no longer creates a repo-local telemetry directory.
  • New persistent opt-out: ~/.config/swamp/telemetry.yaml with 'disabled: true' suppresses telemetry for repo-less runs (durable equivalent of a repo marker's telemetryDisabled). SWAMP_NO_TELEMETRY and --no-telemetry still apply everywhere. repository-configuration.md documents the existing opt-outs and should mention this one.
  • 'swamp telemetry stats' now reads the user-global spool, runs outside a repo, and no longer accepts --repo-dir. Any doc/example showing 'telemetry stats --repo-dir' is stale.
  • 'swamp repo upgrade' migrates unflushed entries from a legacy repo-local spool to the global spool (skipping repos that opted out); the old repo-local folder is left orphaned.

Suggested home: content/manual/reference/repository-configuration.md plus wherever telemetry stats is referenced.

02Bog Flow
OPENTRIAGEDIN PROGRESSSHIPPED+ 1 MOREASSIGNED+ 2 MOREREVIEW+ 4 MOREPR_MERGED+ 1 MORENOTIFICATION_SKIPPED

Shipped

7/18/2026, 12:50:00 AM

Click a lifecycle step above to view its details.

03Sludge Pulse
stack72 assigned stack727/18/2026, 12:07:52 AM

Sign in to post a ripple.