PROJECT / 02 FEATURE ARTICLE

Codex ProviderSwitcher

TYPE Developer ToolSTATUS active

A local Rust CLI and macOS desktop app for safely switching Codex providers and models.

01 Local workflow

Provider control on the workstation

  1. 01list
  2. 02auth
  3. 03models
  4. 04use
  5. 05doctor
  6. 06restore

02 Project overview

A local configuration tool

Codex Provider Switcher is a local configuration tool for switching Codex providers and models. It is available as the Rust CLI cps and a Tauri 2 macOS desktop app; it does not run as a proxy, hosted service, or always-on gateway.

The current public release is v0.1.0. Its universal macOS DMG supports Apple Silicon and Intel, is ad-hoc signed, and is not notarized.

03 Provider control

Choose a provider with a recovery path

  • OpenAI
  • Ollama
  • LM Studio
  • DeepSeek
  • xAI
  • OpenRouter
  • macOS Keychain
  • CPS-managed direct-provider credentials
  • Codex configuration
  • Atomic update
  • Conflict detection
  • Recovery backup

Doctor runs local diagnostics. Restore uses the recovery backup when a previous configuration needs to be recovered.

04 Implementation

Transactional local changes

The cps CLI is written in Rust. The macOS desktop application uses Tauri 2 and provides the same provider and model switching workflow through a native interface. Supported providers include OpenAI, Ollama, LM Studio, DeepSeek, xAI, and OpenRouter.

Configuration changes are written atomically, checked for conflicts, and paired with a recovery backup. CPS-managed direct-provider credentials can be stored in macOS Keychain; Doctor performs local diagnostics, and Restore recovers from the backup.

The v0.1.0 universal DMG targets Apple Silicon and Intel Macs. It is ad-hoc signed and has not been notarized.