← Back to list
01Issue
FeatureShippedSwamp ClubPublic
Assigneesstack72
Relationships
↔ sibling #2828#1233 Docs: update manual telemetry reference for user-global spool and telemetry.yaml opt-out
Opened by stack72 · 7/18/2026· Shipped 7/18/2026
Follow-up to #1129 and #1125.
Telemetry is now user-global (not repo-local). The following manual pages in content/manual/reference/ need updating:
repository-configuration.md
- The
telemetryDisabledfield documents per-repo opt-out but doesn't mention the user-global~/.config/swamp/telemetry.yamldisabled: trueopt-out for repo-less runs. - The priority order should include all four layers:
--no-telemetryflag →SWAMP_NO_TELEMETRYenv var →.swamp.yamltelemetryDisabled: true(per-repo) →~/.config/swamp/telemetry.yamldisabled: true(user-global, repo-less runs). - The spool location (
~/.config/swamp/telemetry/, XDG-aware) is not documented anywhere in the manual.
Telemetry stats
swamp telemetry statsnow reads the user-global spool, runs outside a repo, and no longer accepts--repo-dir. Any existing docs or examples referencingtelemetry stats --repo-dirare stale.
Migration
swamp repo upgrademigrates unflushed entries from the legacy repo-local.swamp/telemetry/spool to the global spool (skipping repos that opted out viatelemetryDisabled: true). The old directory is left in place but unused.
The swamp CLI README has already been updated with these changes.
02Bog Flow
Shipped
Click a lifecycle step above to view its details.
03Sludge Pulse