Skip to main content
Watchfire
AgentsFirst-class

Codex

OpenAI's Codex CLI — long-running coding sessions with isolated homes.

developers.openai.com/codex/cli

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/`.

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.

  • 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
See the full Codex backend page

Setup

Install Watchfire and initialise a project that defaults to Codex. Make sure the agent CLI itself is installed and signed in first.

watchfire init --agent codex

Related docs

Other agents integrations

First-class

Claude Code

Anthropic's CLI coding agent — the original Watchfire backend.

Read more
First-class

opencode

Open-source coding agent — bring your own provider.

Read more
First-class

Gemini CLI

Google's Gemini coding agent on the command line.

Read more

See all integrations

Ready to go

Get started with Watchfire

Install in seconds. Define tasks. Let agents ship code for you.

Download for macOS

Available for macOS, Linux, and Windows

install
# Install via Homebrew (macOS)
$brew tap watchfire-io/tap
$brew install --cask watchfire-io/tap/watchfire
# Set up your project and go
$watchfire init
$watchfire task add "Build the login page"
$watchfire start --all

Includes GUI, CLI, and daemon. Also available via Homebrew.

View on GitHubRead the Docs