CLI usage telemetry

Keelson uses CLI usage telemetry to understand which workflows succeed, find reliability problems, and improve the CLI. It is enabled by default.

What is collected

• Subcommand name
• Exit code and, when available, the published failure code
• Command duration
• Names of flags used, but not their values
• Whether the command ran in an interactive terminal (TTY)
• CLI version
• Type of agent that launched the CLI; it is recorded as unknown when it cannot be determined
• For list commands, only whether the result contained zero, one, or multiple items
• A unique identifier for each event, used to discard duplicates
• The date and time the command ran
• A session identifier. This is a random value created on the device and is replaced after 30 minutes without a recorded command. Stored event rows do not contain account, workspace, or app identifiers. Events are sent using your signed-in credentials, and submission counts are tracked per account, so the transmission itself is not anonymous.

What is not collected

• Your app’s source code or the contents of deployment archives
• The contents of logs, standard output, or standard error
• Environment variable values or values passed to flags
• File paths, workspace names, or app names
• The contents of keelson.yaml
• Conversations with an AI agent

Turn telemetry off

To save your preference, run:

keelson telemetry off

To disable telemetry through the environment instead, set:

KEELSON_NO_TELEMETRY=1

The environment variable takes precedence over the saved preference. While it is set, keelson telemetry on cannot enable telemetry. Disabling telemetry deletes pending event records, and you can check the current state at any time with keelson telemetry status.

Disabling telemetry stops event recording and sending and removes the X-Keelson-Client header. The regular User-Agent header still includes the CLI version as keelson-cli/<version>.

First-send notice

Immediately before the first telemetry send, the CLI displays a one-line notice when it is running in an interactive terminal. It does not display this notice in non-interactive automation.

How this differs from keelson feedback

keelson feedback is a separate mechanism for sharing feedback you provide. It sends only when explicitly run and feedback sharing is enabled. Feedback sharing is disabled by default. Turning CLI usage telemetry on or off does not change the feedback-sharing setting.