Ready to supercharge your AI agents?

Install any skill in seconds. Free to start, no credit card required.

Config Codex CLI · diegosouzapw | DecimalAI

agent toolingby diegosouzapw

Config Codex CLI

diegosouzapw/config-codex-cli

Source diegosouzapw/omniroute ↗License MIT

Step-by-step agent workflow to configure the OpenAI Codex CLI on any machine (Linux, macOS, Windows) to use OmniRoute as an OpenAI-compatible backend. Detects OS and shell, writes config.toml and 7 named profiles, sets environment variables, and verifies the setup.

SkillScore95Maintained

Automatic

AI Engineer pack

Last verified 8/7/2026

What it changes

Passed 21 of 22 test cases with the skill, and 12 of 22 without it.

Without skill55%

With skill95%

Checks it passed that the model alone missed

States that exactly 7 named profiles are configured.
States that default STREAM_IDLE_TIMEOUT_MS is 600000.
Identifies codexSessionAffinityTtlMs as the legacy parameter name.

and 10 more in the full report

9 fixed12 passed either way1 still failing0 broke

Pass-rate lift: +41 pp
Tokens: -14%
Agent turns: 0%
Response time: -54%

Model gemini-3.6-flashMeasured 8/7/2026v121 of 22 cases passed with skill

Tokens, turns and time describe resource use, not a dollar price.

Use this skill

Save it into your project's skills folder. Claude Code picks it up in its next session.

curl -fsSL --create-dirs -o .claude/skills/diegosouzapw-config-codex-cli/SKILL.md https://app.decimal.ai/s/diegosouzapw-config-codex-cli/SKILL.md

Want it pinned and updatable? pip install "decimalai>=0.15", then decimalai skills add diegosouzapw-config-codex-cli, and start Claude Code with claude --plugin-dir "$(git rev-parse --show-toplevel)/.agents"

1 · One-time — install the CLI (docs ↗)

pip install "decimalai>=0.15"

2 · Get the skill — writes .agents/skills/diegosouzapw-config-codex-cli/ and pins it in .decimal/skills.lock

decimalai skills add diegosouzapw-config-codex-cli

No CLI? Get the same file — curl · raw file

curl -fsSL --create-dirs -o .claude/skills/diegosouzapw-config-codex-cli/SKILL.md https://app.decimal.ai/s/diegosouzapw-config-codex-cli/SKILL.md

Raw file: /s/diegosouzapw-config-codex-cli/SKILL.md ↗ · machine-readable summary at /s/diegosouzapw-config-codex-cli.json ↗

Safety checks: 3 of 3 passed

Code scan CleanIntent PassedContent Clean

See it in action

One of 9 test cases the skill fixed. Same model, same prompt, with and without the skill.

1 of 9

Prompt

When running the Codex CLI setup workflow for OmniRoute, how many named profiles must be written to config.toml?

What was checked, without and with the skill
Checked	Without skill	With skill
States that exactly 7 named profiles are configured.	Missed	Passed

case-19 · gemini-3.6-flash · 8/7/2026 · answers are capped and redacted

What's inside

The instructions your model reads when the skill loads.

SKILL.md52 linessingle file

Overview

Quick install

npm install -g omniroute   # or: npx omniroute
omniroute --version

Subcommands

No CLI subcommands mapped for this family yet.

Long-running Codex tasks (#7287)

Two OmniRoute defaults silently break multi-hour Codex sessions. Document them whenever configuring Codex for overnight / multi-hour work. Full guide: docs/guides/CODEX-CLI-CONFIGURATION.md → Long-running tasks.

Session affinity (default off)

Setting: sessionAffinityTtlMs (ms; UI shows Affinity TTL (seconds) under Dashboard → Settings → Routing → Session affinity). Legacy alias: codexSessionAffinityTtlMs.
Default 0 = disabled. Each turn can land on a different account and break prompt-cache / session continuity.
Codex session keys (x-codex-session-id, x-session-id, x-omniroute-session, body prompt_cache_key / session_id) are only used for pinning when TTL > 0.
Max: 86400 seconds / 86400000 ms (24h). Set TTL above the expected task length (e.g. 43200 s for ~12h).

Stream idle timeout (default 10 minutes)

Env: STREAM_IDLE_TIMEOUT_MS (default 600000). Also consider FETCH_BODY_TIMEOUT_MS (same baseline; 0 disables).
Synthetic SSE heartbeats do not reset the idle clock — only real upstream chunks do.
A quiet reasoning turn past the idle window is force-closed (stream_idle_timeout / StreamIdleTimeoutError). Grep logs for Idle timeout: no data from.

Recommended multi-hour recipe

Dashboard → Settings → Routing → Session affinity → Affinity TTL = 43200 (12h) or 86400 (24h max).
OmniRoute environment:

Track record

Benchmark

21 / 22

test cases passed, vs 12 / 22 without

Adoption

Users: 0
Times used: 0

Safety and source details

SkillSafety

✓ 3 of 3 passed

Code scan15 of 15 checks clean

0 critical · 0 warning · 0 info — scanner v4 — 8/3/2026

View 15 scanner checks

live_secretremote_code_executionreverse_shelldata_exfiltrationssrf_metadataagent_snoopinganti_refusaldestructive_commandsobfuscated_unicodeunicode_homoglyphopaque_blobsuspicious_urltool_overreachtrigger_abuseprompt_injection_phrasing

IntentSafe

LLM judge · does the skill do what it claims

ContentClean

LLM judge · policy & harmful-content review

Source

Imported

diegosouzapw / omniroute

skills/config-codex-cli/SKILL.md

View on GitHub ↗

License MITImported 8/3/2026Version v1

More skills from the same source and nearby in the registry, with their headline benchmark lift.