Codex Cache
Codex stores disposable app and connector metadata under ~/.codex/cache so the desktop client can reopen faster, avoid re-fetching provider catalogs, and reuse downloaded UI assets and API capability snapshots. That cache typically includes HTTP response bodies and ETags, serialized connector manifests, model and tool metadata indexes, image thumbnails, temporary archive extracts, and Electron browser cache entries such as V8 code cache and GPU shader data. Kudu removes only these rebuildable cache files, leaving sessions, archives, memories, attachments, generated images, credentials, configuration, plugins, and installed runtimes untouched.
Why clean Codex Cache?
- Stale connector manifests can leave renamed or removed tools visible in the picker, causing failed runs or missing parameters when you try to use them
- Cached model capability metadata from an older sync can make Codex show the wrong context limits or features, which appears as unavailable options or requests rejected after submit
- Corrupt Electron HTTP cache entries can produce blank panes, endlessly spinning sidebars, or connector lists that never finish loading until the cache is rebuilt
- Invalidated V8 code cache after a Codex app update can make the first launch unusually slow or cause renderer crashes until fresh bytecode is generated
- GPU cache and shader blobs from a previous graphics driver version can cause black windows, flickering, or stutter during startup; clearing them forces safe regeneration
- Accumulated thumbnails, temporary archive extracts, and old metadata snapshots can grow the cache folder to hundreds of megabytes, wasting disk space and slowing antivirus scans of the profile directory
Cache paths Kudu targets
Windows
~/.codex/cache |
macOS
~/.codex/cache |
Linux
~/.codex/cache |
Common questions about Codex Cache
Download Kudu and reclaim your disk space.
Available on Windows, macOS, and Linux. No account required, no feature gates, no telemetry without consent. All cleaning targets are open source and community-auditable.