What Telemetry Means in Termix
When we say “telemetry,” we mean the signals that CLI agents emit about their own activity. These are OpenTelemetry (OTLP) log messages that agents like Claude Code, Codex, and Gemini CLI already support. Termix runs a local OTLP receiver on port 4000 and configures the agents to send their logs there.Where Does the Data Go?
Nowhere. It stays on your machine. The telemetry flow is:What Data Does Termix Receive?
From OTLP logs, Termix extracts:| Data | Used For |
|---|---|
| Session ID | Enabling session resume |
| Timing of log events | Confirming the agent is connected |
- Your prompts or what you type to the agent
- The agent’s full responses or generated code
- File contents or repository data
- API keys or credentials
What About Working/Idle Detection?
Working/idle status is not determined from telemetry content. Termix uses I/O heuristics:- How many bytes per second the terminal is outputting
- How long the current burst of output has been going
- Whether there’s been silence for more than 2 seconds
What About the Message Preview?
The sidebar preview (last message from the agent) comes from reading the terminal’s output buffer — the same text you see in the terminal. This is local to your browser and is not sent anywhere.Can I Disable Telemetry?
Yes. Per agent:- Open Settings > CLI Agents
- Select the agent
- Uncheck Telemetry
- Session resume (no session ID capture)
- Telemetry setup detection
- Slightly less accurate status detection for some agents
Auto-Setup: What Changes on My System?
When you click “Configure automatically” for an agent, Termix writes to the agent’s config file:| Agent | File Modified | What’s Added |
|---|---|---|
| Codex | ~/.codex/config.toml | [otel] section with OTLP endpoint |
| Gemini CLI | ~/.gemini/settings.json | telemetry object with local endpoint |
| Claude Code | Nothing | Uses environment variables (no file changes) |
| OpenCode | ~/.config/opencode/plugins/ | Plugin file copied (one-time) |