Disable & uninstall
Restore the official Codex to how it was, or remove ReCodex completely.
Just restore the official Codex
To put the official Codex back the way it was without uninstalling ReCodex:
- If you only used the CLI: run
gcodex logout;~/.codexgoes back to the configuration and sign-in you had before. - If you used Desktop: quit Desktop completely (
⌘Qon macOS), then rungcodex desktop disable. It restores~/.codex, turns off the network handling and removes the certificate; MCP servers and skills you added in the meantime are kept.
Running gcodex again later takes over ~/.codex again.
Uninstall completely
Follow these steps in order. If any step fails, it stops and keeps the files needed to recover, so your configuration is never left half-restored.
Finish your current sessions
Save your work and quit Codex Desktop completely (⌘Q on macOS, or quit from the system tray on Windows). Uninstalling stops the background service, which also interrupts running Codex CLI sessions.
Run the uninstall command
gcodex uninstallIt first restores ~/.codex and the Desktop configuration, then removes the background network component (asking for administrator authorization once more) and the certificate, stops the background service, and deletes gcodex and its local data. It asks 确认继续? [y/N] ("continue?") before starting; add --yes when running it from a script.
- To keep an official codex that you downloaded with
gcodex update: add--keep-codex. A codex you installed yourself via npm, Homebrew or similar is never touched. - To keep the logs: add
--keep-logs.
Clean up what's left (optional)
These are not removed automatically; delete them yourself if you like:
- the lines that load ReCodex in your shell configuration files (they start with
# ReCodex CLI), plus~/.recodex/envand~/.recodex/env.fish; - the ReCodex directory in your Windows user
PATH; - the configuration backups in
~/.recodex-desktop.
Confirm everything is clean
command -v gcodex # no output = removed (check in a new terminal)
launchctl print system/com.recodex.net-helper # "not found" = background component removed
dscacheutil -q host -a name chatgpt.com # a public IP, not 127.0.0.1Uninstalling ReCodex does not cancel your subscription; reinstall and sign in to continue. It also doesn't free the device slot in the console; to cut this computer off on the server side too, revoke it on the Devices page.