Raycast extension + CLI

Keep every Codex workspace within reach

fxCodex gives personal and work accounts their own Codex environment, then lets you focus or open the right one without breaking your flow

Install the CLI
curl -fsSL https://capturecontext.dev/tools/fxcodex/install.sh | sh

macOS 14+ · Downloads and verifies the signed GitHub release

A separate place for each Codex context

Keep personal and work sessions available without signing out or moving local state between them

Separate local profiles

Each managed workspace keeps its own Codex settings, sessions, integrations, and Electron data

Return to the right window

fxCodex remembers each running instance and focuses it instead of launching a duplicate

Codex.app, if you want it

Opt in to restore the Codex name when an update installs the app as ChatGPT.app

From Raycast to the terminal

The extension is the fastest path for everyday navigation; the CLI keeps the same workspace boundary in scripts and terminal sessions

  1. 01

    Open fxCodex

    Launch the Raycast command and choose primary to use the Codex environment already on your Mac

  2. 02

    Create a workspace

    Press Command-N for a separate work or personal environment, then sign in once in its Codex window

  3. 03

    Focus or open

    Press Return whenever you need it. Running workspaces are focused; stopped workspaces are opened

Branding

Keep calling Codex, Codex

Automatic renaming is opt-in. When enabled, fxCodex restores ChatGPT.app to Codex.app before subsequent commands

ChatGPT.appCodex.app
fxcodex preferences set auto-rename true

How it works

Each workspace keeps its own state and its window

The built-in primary workspace keeps Codex’s normal locations. Managed workspaces receive separate CLI and Electron data paths, while a validated runtime record connects each workspace to its running app instance

Desktop state is isolated explicitly

Managed app instances receive workspace-specific CODEX_HOME and CODEX_ELECTRON_USER_DATA_PATH values, plus Electron’s matching --user-data-dir argument

The CLI follows the selected workspace

Terminal commands point CODEX_HOME at the selected workspace, so scripts and interactive sessions use the same Codex profile

fxcodex workspace create work --use --open

Focus the instance that is already open

fxCodex caches the process identifier, bundle URL, and launch date for each workspace. It validates that identity before activating the existing window, avoiding accidental focus or duplicate launches

No account-switching service

Nothing switches an account inside Codex. Each app instance starts with a different local profile, and fxCodex never asks for account credentials or API keys

Ready when Raycast is

Open the right Codex workspace in a few keystrokes