Codex Launcher

Interactive terminal launcher for Codex CLI with multi-profile support and a Codex-themed interface.

Features

Multi-Profile Management

• Create isolated Codex environments with separate auth, config, sessions, and logs
• Each profile lives in its own directory under %LOCALAPPDATA%\CodexLauncher\profiles\<name>
• Switch between profiles instantly
• Login, delete, open folder, and edit config per profile

Codex-themed Interface

• Codex green (#00D4AA) color scheme
• ANSI alternate screen buffer for clean, flicker-free rendering
• Arrow-key navigation with highlighted selection and (ACTIVE) badge
• Panel-style feedback for all operations (success, error, info)

Input & Navigation

• ESC key: Cancel and go back at any step
• Type exit: Text-based cancel alternative
• Ctrl+C: Double-press to exit; single press shows warning
• Backspace: Full editing support in text input fields

i18n

• English and Simplified Chinese
• Language switchable from Configuration menu

Installation

npm install -g @kikkimo/codex-launcher

Usage

Run codex-launcher in your terminal.

Main Menu

  → Launch Codex
    Profile Management
    3rd-party API Management  (Coming soon)
    Configuration
    Version Update Check
    Exit

Profile Management

  → Add Profile          — Create a new isolated environment
    Delete Profile       — Remove a profile with confirmation
    Switch Active        — Set the default profile
    Login Profile        — Authenticate with OpenAI
    Open Profile Folder  — Browse profile files
    Edit Profile Config  — Open config.toml in editor
    Sync to Default      — Mirror profile contents to ~/.codex
    Back

Sync to Default Profile

Mirror any profile's contents (auth, config, sessions, logs) to ~/.codex. Shows a detailed confirmation page with source/target paths and warnings, then displays live spinner progress during copy and config patching. Automatically retries if the target directory is locked (EBUSY/EPERM). Tracks which profile was last synced and shows a badge in the selection list.

Launch Modes

When launching, select a profile then choose:

• Default — Standard Codex launch
• YOLO Mode — Launch with --full-auto

Requirements

• Node.js: 20.0.0 or higher
• Codex CLI: Installed and accessible via codex command
• Platform: Windows

Configuration

Data stored at %LOCALAPPDATA%\CodexLauncher\:

CodexLauncher/
  config.json              — Active profile, language, last synced profile
  profiles/
    personal/
      display.json         — Display name, creation timestamp
      codex_home/
        config.toml        — Codex configuration
        sessions/
        logs/

License

MIT