Codex IDE for Emacs plugin
An Emacs package that runs Codex as a regular buffer: diffs, approvals and file links inside the editor.
- 109 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The package launches Codex, which edits files and runs commands after approval in the buffer.
Install
- Works in
Manual install
Make sure Emacs is at least 28.1 and `codex` and `transient` are installed. On Emacs 30 add `(use-package codex-ide :vc (:url "https://github.com/dgillis/emacs-codex-ide" :rev :newest) :bind ("C-c C-;" . codex-ide-menu))` to the configuration.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The package launches Codex, which edits files and runs commands after approval in the buffer.
This is third-party code. Review the repository files before installing.
What it does
Codex IDE for Emacs connects to `codex app-server` directly, with no terminal wrapper. A Codex session looks like an ordinary Emacs buffer: code blocks are highlighted by language modes, diffs are shown with Emacs tools, file references become clickable widgets and command and edit approvals happen in the buffer itself. Output detail folds and unfolds, and the header line shows token and quota usage. A session management mode searches and restores past conversations, and several sessions can run at once. An optional MCP bridge lets Codex learn about the current Emacs window and buffer.
Who it is for. Emacs users who want to work with Codex without leaving the editor or switching to a terminal.
Good fit when
- Codex output is easier to read as a highlighted buffer than in a terminal.
- Edits are approved right in the session, looking at a familiar diff.
- You need to return to yesterday's session and find a fragment in it.
- Codex should see the current buffer and selected region.
Not a fit when
- Your Emacs is older than 28.1.
- You work in another editor: Claude Code has a separate analog.
- You want raw Codex terminal output without editor integration.
Example request
Open Codex in this project through the codex-ide menu, ask it to fix the failing test and show the diff in a buffer.Limitations
Emacs 28.1 or newer, Codex CLI on `PATH` and the `transient` package are needed. The optional MCP bridge requires `python3` and `emacsclient`. Installing via `use-package` with `:vc` works on Emacs 30 and newer, while older versions need `straight.el`. The package relies on `codex app-server`, whose protocol changes along with Codex, so mismatches are possible after CLI updates. Permissions and Codex sandbox come from the settings menu: check them before launching. The last commit is dated July 2026.
How to disable. Remove `codex-ide` from the Emacs configuration and the package itself. Codex sessions stay in the Codex CLI directory.
FAQ
How does it differ from terminal mode?
There is no terminal wrapper: diffs, highlighting and links use Emacs tools, and approvals happen in the buffer.
How do I open the menu?
The example binding `C-c C-;` calls `codex-ide-menu`, where you choose the model, sandbox and other session settings.
Can I run several sessions?
Yes. Session management mode lists them and lets you search and restore past ones.
What does the MCP bridge give?
Codex learns about the current Emacs window and buffer. The bridge is optional and needs `python3` and `emacsclient`.
What about Emacs versions?
Emacs 28.1 or newer is needed. The `:vc` form works on Emacs 30, while other versions install via `straight.el`.
Discussion
No questions or reviews yet.
Related
PluginsCodex Bridge sends questions and file analysis from Claude Code, Cursor and VS Code to the official Codex CLI via Python MCP.
An Emacs package for Claude Code: per-project sessions and an MCP server exposing buffers, LSP and diffs to the agent.
Codex MCP Tool (cexll)
Codex MCP Tool
An MCP server that sends tasks to Codex CLI from Claude Code and Cursor: code review via @ refs, a sandbox, patch edits, ideas
Statusline HUD for Codex CLI inside tmux: context fill, tokens, branch, MCP servers and subagents stay visible in the session.
A Codex plugin: 55 explicitly invoked skills and 23 poteto-mode playbooks for code tracing, TDD and review.
OpenAI's official plugin: Codex reviews of your changes and task delegation to Codex from inside a Claude Code session
README in short
Describes the native client's features, screenshots, requirements and installation through `use-package` and `straight.el`.