codex-profiles - Chai Pin Zheng

codex-profiles

Chai Pin Zheng · AI-Native IDEs & Editors · Updated Aug 12, 2026

codex-profiles is a dependency-free Bash wrapper that manages separate local environments for Codex CLI and ChatGPT Desktop. It enables users to switch between different accounts, configurations, and plugin sets by mapping them to distinct local directories without the need to manually copy or move authentication tokens.

Recent Updates

Version 0.7.0 adapted the tool to OpenAI's integrated ChatGPT desktop app, removing the need for manual app cloning and patching while maintaining compatibility for named parallel sessions.

As of Aug 12, 2026

Key Features

Isolated CODEX_HOME directories per profile
Separate Electron user data for named ChatGPT Desktop windows on macOS
No manual copying, parsing, or migration of authentication tokens
Compatible with CLI-only workflows and parallel desktop window instances
Diagnostic tools like doctor and status for local state verification

Who It's For

✓ Best For

Developers who manage multiple accounts, such as work, personal, and educational identities, and want to keep their configurations, sessions, and plugins isolated.

✗ Not Ideal For

Users requiring strict security boundaries, as this tool provides local-state separation rather than OS-level sandboxing, and it does not guarantee account equality between CLI and Desktop.

Pricing

Open Source

The tool is free and open-source under the MIT license.

Verdict

A highly practical and lightweight utility for power users who need to manage multiple ChatGPT/Codex environments cleanly and efficiently on a single system.