Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.clideck.dev/llms.txt

Use this file to discover all available pages before exploring further.

Codex is OpenAI’s CLI coding agent. CliDeck 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, CliDeck shows a setup toast: “Codex — Status Tracking”. Click Configure automatically.CliDeck 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

CliDeck 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. CliDeck 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 CliDeck:
  1. Open Settings > CLI Agents > Codex
  2. Toggle off CliDeck integration
CliDeck 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 CliDeck. Check for the latest version with npm update -g clideck.