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

Get it on RaycastView on GitHub

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 uses Codex's normal directories. Each managed workspace gets separate CLI and Electron data paths. A runtime record connects it to the correct app instance

Give each window separate desktop data

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

Use the same profile in the terminal

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 window that is already open

fxCodex records the process identifier, bundle URL, and launch date for each workspace. It checks those values before activating a window, which prevents duplicate launches and focus on the wrong process

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

Honorable dependencies

Built on excellent open-source work

fxCodex uses these libraries for terminal prompts, command parsing, dependencies, and local process control

PromptberryPromptberry runs fxCodex's guided terminal prompts.PointFreeDependencies, Parsing, and Case Paths isolate effects and model command input.Swift Argument ParserSwift Argument Parser declares and parses fxCodex's commands.

Ready when Raycast is

Open the right Codex workspace in a few keystrokes

Get it on RaycastView on GitHub