Skip to main content
Codex is OpenAI’s CLI coding agent. Termix supports it with one-click telemetry setup.

Setup

1

Launch a Codex session

Click Codex in the session launcher. The session starts normally.
2

Configure telemetry

On first launch, Termix shows a setup toast at the top of the terminal: “Telemetry not configured for Codex”. Click Configure automatically.Termix adds an [otel] section to ~/.codex/config.toml with the correct endpoint settings.
3

Restart the session

After configuration, click Restart Session on the toast. The new session will have telemetry active.
This is a one-time setup. All future Codex sessions will have telemetry enabled automatically.

What the Config Looks Like

Termix adds this to your ~/.codex/config.toml:
[otel]
exporter = { otlp-http = { endpoint = "http://localhost:4000/v1/logs", protocol = "json" } }
You can also add this manually if you prefer.

Session Resume

Codex supports session resume. Termix captures the session ID from telemetry and uses codex resume <sessionId> to reconnect to previous sessions.

Disabling Telemetry

If you want to stop sending telemetry from Codex to Termix:
  1. Open Settings > CLI Agents > Codex
  2. Uncheck Telemetry
Termix will remove the [otel] section from your Codex config file.
If Codex releases a major update that changes its configuration format, you may need to update Termix. Check for the latest version with npm update -g termix-cli.