Codex (Desktop)

Codex Desktop runs on the same adapter as Codex CLI. There is no separate install for Desktop. Once you have run the codex-install command, Desktop loads the hooks from ~/.codex/hooks.json automatically.

Install

Follow the Codex (CLI) install. The codex-install command writes ~/.codex/hooks.json, and Codex Desktop reads that file. Nothing else is needed.

What differs from the CLI

There are no documented capability differences between Codex Desktop and Codex CLI. Every engine command works identically with the TOKEN_OPTIMIZER_RUNTIME=codex prefix.

The aggressive default includes prompt, subagent, and silent Bash PostToolUse hooks. To keep only Stop plus Bash PostToolUse bookkeeping, use telemetry. Its name does not mean visible Desktop rows:

TOKEN_OPTIMIZER_RUNTIME=codex python3 skills/token-optimizer/scripts/measure.py codex-install --profile telemetry

Verify

Same doctor as the CLI:

TOKEN_OPTIMIZER_RUNTIME=codex python3 skills/token-optimizer/scripts/measure.py codex-doctor --project "$PWD"

The dashboard runs on port 24843 at http://localhost:24843/token-optimizer.

Uninstall

Uninstall from the Codex CLI side. Removing the plugin and the daemon there removes them for Desktop too, because both surfaces share ~/.codex/hooks.json. See Codex (CLI).

Note

The hook profiles and the upstream Codex API gaps apply equally to Desktop. See the Codex platform reference for the full capability list.

See also

• Codex (CLI) for the install steps that Desktop inherits.
• Codex platform reference.
• Configuration.