Codex

Fastest install: the one-line curl — it detects the agent frameworks you already have and installs Telem into as many of them as you select in one pass. The steps below are the manual path.

Telem on Codex is two pieces:

• The hosted MCP remote — a [mcp_servers.telem] table in ~/.codex/config.toml pointing at https://mcp.telem.ai/mcp. This is what gives Codex the tools.
• The telem plugin — what makes your searches show up as a usable record in the console, and what reads your .telem config. It also carries the same preference skill the other harnesses do.

Install

1. Get an API key in the Telem console, under API keys in your project — see Authentication.

2. Run the one-line installer and pick Codex, or skip the menu:

   curl -fsSL https://docs.telem.ai/alpha_install.sh | sh -s -- --client codex

   It writes the hosted [mcp_servers.telem] table with your key, then installs the plugin and pre-grants its hook trust (a Codex plugin hook is silently skipped until trusted). Turning off Codex’s builtin web_search is offered separately and only happens if you say yes.

3. Restart Codex and ask it to search — the run shows up in the console.

The installer’s direct npm form is npm create @telemai -- --client codex.

What you get

The hosted tools: telem_search, telem_fetch and telem_providers — the full table is on the MCP server page. The bare mcp add tool-name shape applies here: mcp__telem__telem_search / …__telem_fetch.

Configuration

.telem/telem.json applies here — the same file every other Telem surface reads, in the same order: a project file, then your user file, then TELEM_* variables. Set a tier or a provider set once and searches from Claude Code follow it.

{
  "tier": "extended",
  "providersInclude": ["exa", "brave"]
}

Full parameter reference →

Two limits worth knowing: provider_overrides is not carried on this surface, and the model never sees these settings — they are yours, not something it can choose per call.

The plugin is the half that reads the config. A [mcp_servers.telem] table on its own gives Codex the tools but not your settings, so a Codex set up without the plugin searches with the deployment defaults.

Troubleshooting

401 on every call

The Authorization line in [mcp_servers.telem] is missing or carries a rotated key. Re-run the installer — it reconciles the header against your current key — or edit the table by hand.