tapes

Telemetry

tapes collects anonymous usage telemetry to help improve the CLI. Telemetry is completely optional and can be disabled at any time.

What We Collect

All telemetry data is anonymous. We collect:

• Command usage — Which CLI commands are run (e.g., tapes serve, tapes search)
• Feature usage — Which features are used (server modes, search result counts)
• System info — Operating system and architecture
• Version info — tapes CLI version
• Error types — General error categories (not error messages or stack traces)

We do not collect:

• Conversation content or prompts
• API keys or credentials
• File paths or project names
• IP addresses or location data
• Any personally identifiable information

Anonymous Identity

A random UUID is generated on first run and stored in ~/.tapes/telemetry.json. This ID is used only to count unique users and is not linked to any personal information.

Disabling Telemetry

You can disable telemetry using any of these methods:

Config File

Add to your .tapes/config.toml:

[telemetry]
disabled = true

CLI Flag

Use the --disable-telemetry flag with any command:

tapes --disable-telemetry serve

Environment Variable

Set TAPES_TELEMETRY_DISABLED:

export TAPES_TELEMETRY_DISABLED=1

Accepts 1, true, or yes.

CI Detection

Telemetry is automatically disabled in CI environments. The following environment variables are detected:

• CI
• GITHUB_ACTIONS
• GITLAB_CI
• CIRCLECI
• TRAVIS
• JENKINS_URL
• BUILDKITE
• CODEBUILD_BUILD_ID

Data Handling

Telemetry data is sent to PostHog, a privacy-focused analytics platform. Data is used solely for understanding usage patterns and improving tapes.