codex-profiles
Provide isolated CODEX_HOME directories for Codex CLI/Desktop users, enabling safe multi-account switching without copying auth.json.
Tool overview
codex-profiles is a lightweight Bash utility that lets you switch between multiple Codex accounts by pointing the CODEX_HOME environment variable to isolated profile directories. Each profile holds its own auth.json, conversation history, and usage stats, so you can manage personal, work, school, or client identities without manually copying token files. This works for both the Codex CLI and the Codex Desktop application on macOS and Linux.
The main benefit is strict isolation: no shared chat logs or token counters between profiles, preventing data leakage and billing confusion. It has zero dependencies—just clone the repository and source the script. Commands are short, support tab completion, and integrate smoothly into developer workflows. For anyone who switches accounts multiple times a day, it saves considerable time and mental overhead.
However, the tool is limited to macOS and Linux; Windows is not supported. Users need basic terminal skills: forgetting to source the script or leaving an old session open may still point to the wrong profile. Because profiles are just directories, accidental deletion could lose account bindings, so users should back up important data.