Codex
OpenAI's Codex CLI — long-running coding sessions with isolated homes.
What is Codex?
OpenAI Codex CLI is OpenAI's command-line coding agent. It runs locally, drives long agentic engineering sessions, and reuses your existing OpenAI login and config from `~/.codex/`.
Vendor: developers.openai.com/codex/cli
Codex + Watchfire
Watchfire gives each Codex session its own `CODEX_HOME` under `~/.watchfire/codex-home/<session>/`, while reusing your real `~/.codex/auth.json` and `config.toml`. That means session-specific prompts, logs, and `AGENTS.md` stay isolated from your personal Codex history — but auth and config still carry over from your normal setup.
Install with Codex as default
Install Watchfire, then initialise a project that defaults to Codex. Make sure the agent CLI is installed and authenticated outside Watchfire first.
watchfire init --agent codexSee the installation guide for platform installers and Homebrew taps.
Interop notes
- Each session gets its own `CODEX_HOME` directory
- Reuses `~/.codex/auth.json` and `config.toml` from your normal setup
- Watchfire writes the generated `AGENTS.md` into the session home
- Complete Codex login once before running through Watchfire