OpenAI Codex CLI v0.138.0 Changelog
What changed in Codex CLI v0.138.0, released 2026-06-08 โ explained in plain English.
- Desktop Integration: Easily hand off chat threads and workspaces to the Codex Desktop app, and benefit from smarter tracking of local image file locations.
- Performance Boosts: Enjoy significantly faster startup times, speedier history searches, and snappier data streaming.
- Enhanced Controls & Fixes: Gain flexible control over AI reasoning effort and experience various UI, error message, and thread-naming fixes.
Want a heads-up when OpenAI Codex CLI updates?
We email you the moment a new OpenAI Codex CLI version drops โ plus plain-English release notes like these. No spam.
This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.
This update is all about making the Codex CLI (the command-line version of OpenAI's coding assistant) play nicer with the Desktop app, handle images smarter, and run much faster. If you love coding with Codex but prefer switching between a text-based terminal and a visual desktop app, or if you work with a lot of project plugins, this release makes your workflow a whole lot smoother.
What's new
- Desktop Handoff: You can now easily send your current chat thread from the command line straight to the Codex Desktop app on Mac and Windows. Windows workspaces can also open directly in the Desktop app.
- Smarter Image Handling: When you upload a local image or generate a new one, Codex now knows exactly where that file is saved on your computer. This makes it much easier for the AI to edit or reference those images later.
- Better "Thinking" Controls: You have more flexible control over how much "reasoning effort" (how deeply the AI thinks before answering) Codex uses, even if your terminal doesn't support standard keyboard shortcuts.
- Advanced Plugin Data: If you write scripts to automate your plugins (add-ons that give Codex extra abilities), you can now get cleaner, more detailed data back in JSON format (a standard, easy-to-read data format for computers).
Improvements
- Faster Startup: The text interface (TUI) now starts up much quicker by remembering your plugins instead of scanning them from scratch every single time.
- Speedier History Searches: Using the command to jump back into your last session is now much faster, even if you have a massive history of past chats.
- Snappier Performance: Reading long message histories and streaming data from local AI models is much faster thanks to under-the-hood code optimizations.
- Clearer Docs: The main setup guide (the README file) was cleaned up and simplified to make it easier to follow.
Fixes
- Accurate Thread Names: When you split (fork) a chat thread, it will now keep the custom name you gave it instead of resetting to the very first prompt's name.
- No More Accidental Submissions: Pasting multiple lines of text into the
/goal editcommand won't accidentally submit your message before you are ready. - Cleaner Screen Layout: Fixed a bug where the text interface would awkwardly add extra blank lines while streaming answers. Also, if you cancel a prompt, your cursor will stay at the end of the text so you can keep typing naturally.
- Better Error Messages: If Codex fails to save your settings, it will now tell you *why* (like if your folder is set to "read-only") instead of just failing silently.
- More Reliable Workspace Loading: Fixed an issue where Codex would miss project instruction files (
AGENTS.md) when working with linked or remote folders.
Breaking changes
No breaking changes in this release.
How to upgrade
Update to OpenAI Codex CLI v0.138.0 by running:
codex --upgrade
This is our plain-language summary. Read the complete, official notes on the OpenAI Codex CLI official changelog โ.
