# fxCodex for Raycast URL: https://www.raycast.com/maximkrouk/fxcodex > Manage custom Codex workspaces from Raycast - Install: raycast://extensions/maximkrouk/fxcodex - Author: [Maxim Krouk](https://www.raycast.com/maximkrouk) - Installs: 43 - Platforms: macOS - Categories: Developer Tools, Applications - Updated: 2026-10-09 - Source: https://github.com/raycast/extensions/tree/c33bf4cb4b9ad70c2b93432ee713ffb7486ed331/extensions/fxcodex/ ## Commands - **fxCodex**: Manage fxCodex workspaces, application, and executable ## README ### fxCodex Manage isolated [Codex](https://openai.com/codex/) desktop workspaces without leaving Raycast. fxCodex keeps each managed workspace's Codex settings, sessions, integrations, and browser data separate. Multiple workspaces can remain open at the same time, and selecting a running workspace focuses its existing window instead of launching a duplicate. #### Requirements - macOS - [Raycast](https://www.raycast.com/) - The [Codex](https://openai.com/codex) desktop app installed as either `Codex.app` or `ChatGPT.app` The extension detects an existing `fxcodex` CLI or can install one from a verified GitHub release. #### Getting Started 1. Open **fxCodex** from Raycast. 2. If no CLI is detected, open **Preferences**, choose **Install fxCodex…**, and select a release and destination. 3. Select **primary** to open your existing Codex environment. 4. Press `Command-N` to create an isolated workspace such as `work` or `personal`. 5. Press Return on a workspace to focus or open it and close Raycast. The current workspace is selected automatically whenever the command loads. Open the action panel with `Command-K` for the complete set of actions. #### Workspaces - **Focus or Open** focuses a running workspace or launches it, then closes Raycast. - **Focus or Open Without Closing** performs the same operation while keeping Raycast open. Its default shortcut is `Command-Return`. - **Set as Current** selects the workspace used when a command does not specify one explicitly. - **Create Workspace…** creates a new isolated workspace. Use `Command-N` from the main view. - **Set Icon…** opens a searchable grid containing Raycast icons. You can also choose a custom image using action panel. - **Rename…** renames a stopped managed workspace while preserving its selected icon. - The **Copy Workspace** section exposes the workspace name, ID, and path. Its PID is also available while the workspace is running. - **Show in Finder…** reveals the workspace, `CODEX_HOME`, or browser-data directory. The primary workspace can have a custom icon, but its name and data lifecycle are managed by Codex rather than fxCodex. ##### Erase and Delete Destructive actions remain visible while a managed workspace is running, but are disabled until it is stopped. Once available, they always require confirmation: - **Erase Data…** removes the workspace's Codex settings, sessions, integrations, and browser data while preserving the workspace itself. - **Delete Workspace…** permanently removes the workspace and all of its managed data. #### Codex Application Name The **Codex** management screen detects the desktop application under either supported name. It can rename `ChatGPT.app` to `Codex.app`, restore the `ChatGPT.app` name, and optionally enforce the Codex name before fxCodex commands run. Renaming requires confirmation. Restoring the ChatGPT name automatically disables the auto-rename preference. #### Executable Management The extension does not bundle the CLI. **Preferences** remains available even when no executable exists or the selected executable fails, so installation and recovery do not depend on a working CLI. The executable manager discovers `fxcodex` in every directory from Raycast's `PATH`, plus `~/.local/bin`, `/opt/homebrew/bin`, and `/usr/local/bin`. You can also choose an existing executable in Finder. Every discovered or registered path appears separately and can be selected, so a Homebrew version used in the terminal can coexist with a version pinned for Raycast. Symbolic links are marked in the list and expose their resolved original in Finder. The installer loads releases from [`CaptureContext/fxcodex`](https://github.com/CaptureContext/fxcodex/releases), lets you open each release on GitHub, and verifies the downloaded universal executable's SHA-256 checksum, code signature, and reported version. The release marked **Tested** is the fallback version exercised with the current extension update. It is deliberately updated by the extension author, not inferred from the latest GitHub release. Installations can target: - the current user at `~/.local/bin/fxcodex`, with an option to add the directory to the user's shell `PATH`; - a versioned directory under Raycast's extension support folder; - any custom directory, also with optional `PATH` setup; - Homebrew using `brew install capturecontext/tap/fxcodex` for the latest stable formula. Versioned extension-support directories and custom destinations make it possible to retain several releases at once. Extension-managed direct installs can be replaced with any available release or uninstalled. Homebrew installs can be upgraded independently. Raycast disables CLI self-updates when the selected executable is installed in extension support, so a known-compatible version stays pinned until it is manually replaced. User and custom installations honor the CLI's automatic-update preference, while Homebrew controls upgrades for its installation. #### Status and Diagnostics The **Status** screen summarizes the current workspace, running workspaces, Codex application, selected executable, and support folder. It also contains diagnostics, so recovery information remains available alongside partially valid status data. If part of the status data is missing or malformed, the valid sections remain available and the reported problems identify what could not be read. Diagnostics read extension preferences and fxCodex metadata files directly by default, without depending on a working CLI. An optional CLI diagnostics action runs raw status and version probes when needed. Open the action panel with `Command-K` to copy the complete report, its JSON representation, or only the direct storage diagnostics. Review diagnostics before sharing them because workspace names and local file paths may be included. #### Privacy Workspace management happens locally and the extension does not require API keys or account credentials. Custom workspace icons are copied into Raycast's extension support directory. GitHub is contacted when the executable installer is opened and when a release is installed. Homebrew is invoked only after an explicit install, update, or uninstall action. #### Executable Provenance The downloadable CLI is built from the public [`capturecontext/fxcodex`](https://github.com/capturecontext/fxcodex) source. Its GitHub Actions release workflow builds native Apple silicon and Intel executables, combines the universal binary, signs it with a Developer ID Application certificate, submits it to Apple's notary service, and publishes a matching SHA-256 checksum with the [GitHub release](https://github.com/capturecontext/fxcodex/releases/latest). The extension invokes the CLI through a versioned JSON interface and does not require a background daemon. #### Development Local extension development requires Node.js 22.14 or newer and npm 7 or newer. ```sh npm ci npm run dev ``` Before submitting changes, run: ```sh npm run lint npm run build ``` `npm run publish` validates the extension and opens or updates its pull request in the public [`raycast/extensions`](https://github.com/raycast/extensions) repository. #### License and Attribution fxCodex is available under the [MIT License](https://github.com/capturecontext/fxcodex/blob/main/LICENSE). It is an independent open-source project and is not affiliated with or endorsed by OpenAI or Raycast.