cargo agents telemetry

Manage opt-in, per-user usage telemetry. See the telemetry design chapter for the event format and the [telemetry] configuration for the underlying config key.

Telemetry is off by default, local-first, and never uploaded automatically — you share it yourself. The preference is also offered during cargo agents init.

Usage

cargo agents telemetry [status]      # whether enabled, where data lives, how much is stored (default)
cargo agents telemetry enable        # turn on collection (writes [telemetry] enabled = true)
cargo agents telemetry disable       # turn it off
cargo agents telemetry show [--count N]   # print recent events (JSON lines) for inspection

Where the data lives

When recording is wired in, anonymous events will be appended as JSON lines to per-day files under ~/.symposium/telemetry/ (e.g. events-2026-06-23.jsonl), with files older than 30 days rolled off automatically. Events record counts and coarse metadata only (session starts, prompts, tool names) — no prompt text, command lines, or file paths.