Codex for RouterLab

codex-scionos is a RouterLab launcher for the official OpenAI Codex CLI. It keeps normal Codex usage intact while adding guided onboarding, RouterLab model selection, secure token storage, and a doctor command for support.

🇫🇷 Lire en français

Highlights

• guided launch for new users
• --strategy to choose a model without opening the menu
• --service llm for invitation-only RouterLab LLM access
• --no-prompt for automation and CI
• --list-strategies to inspect available routes
• doctor for quick local diagnostics
• auth login|status|change|logout|test to manage the token
• custom Codex provider scionos, without editing ~/.codex/config.toml

Requirements

• Node.js 22 or newer
• official Codex CLI (npm install -g @openai/codex)
• a RouterLab token from routerlab.ch/keys
• or an invitation token for --service llm

Quick Start

npx codex-scionos
npx codex-scionos --list-strategies
npx codex-scionos --service llm --list-strategies
npx codex-scionos doctor
npx codex-scionos auth login
npx codex-scionos auth login --service llm
npx codex-scionos auth test
npx codex-scionos --strategy gpt-5.5
npx codex-scionos --strategy gpt-5.4
npx codex-scionos --strategy gpt-5.4-mini
npx codex-scionos --service llm --strategy gpt-5.4-special
npx codex-scionos --no-prompt --strategy gpt-5.5 exec "Summarize this repo"

Services

• routerlab uses https://routerlab.ch/v1
• llm uses https://llm.routerlab.ch/v1
• llm is intended for invitation-only access
• routerlab and llm tokens are stored separately

Strategies

• default: keep the configured Codex model and route through RouterLab
• gpt-5.5: force gpt-5.5
• gpt-5.4: force gpt-5.4
• gpt-5.4-mini: force gpt-5.4-mini
• gpt-5.3-codex: force gpt-5.3-codex
• gpt-5.4-special: force gpt-5.4-sp on --service llm
• deepseek-v4-beta: force deepseek-v4-pro on --service llm

Token Management

Token resolution order:

1. SCIONOS_ROUTERLAB_TOKEN
2. secure local storage via codex-scionos auth login
3. manual prompt in guided mode

Secure storage backends:

• Windows: local DPAPI-encrypted file bound to the current user
• macOS: Keychain
• Linux: Secret Service via secret-tool

Codex Compatibility

The wrapper forwards normal Codex arguments. On launch, it only adds -c overrides for the custom provider:

• model_provider="scionos"
• model_providers.scionos.name="RouterLab" or model_providers.scionos.name="LLM (invitation only)"
• model_providers.scionos.base_url="https://routerlab.ch/v1" or https://llm.routerlab.ch/v1
• model_providers.scionos.env_key="SCIONOS_ROUTERLAB_TOKEN"
• model_providers.scionos.wire_api="responses"
• model="<strategy model>" when --strategy forces a specific model

Development

npm install
npm test
npm run lint
node index.js

License

MIT. See LICENSE.