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
Plugin

Extended access

Why this level

  • The package launches Codex, which edits files and runs commands after approval in the buffer.
All reasons and checks

dgillis/emacs-codex-ide

Install

Works in

Manual install

Text for your agent

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 review

Extended 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.

Plugins

Codex Bridge sends questions and file analysis from Claude Code, Cursor and VS Code to the official Codex CLI via Python MCP.

MCP serverExtended access120Repository stars

An Emacs package for Claude Code: per-project sessions and an MCP server exposing buffers, LSP and diffs to the agent.

PluginExtended access67Repository stars
Needs a VPN

An MCP server that sends tasks to Codex CLI from Claude Code and Cursor: code review via @ refs, a sandbox, patch edits, ideas

MCP serverBroad access176Repository stars

Statusline HUD for Codex CLI inside tmux: context fill, tokens, branch, MCP servers and subagents stay visible in the session.

CLIExtended access80Repository stars

A Codex plugin: 55 explicitly invoked skills and 23 poteto-mode playbooks for code tracing, TDD and review.

PluginExtended access107Repository stars
Editors’ pick

OpenAI's official plugin: Codex reviews of your changes and task delegation to Codex from inside a Claude Code session

PluginExtended access35.1KRepository stars

README in short

Describes the native client's features, screenshots, requirements and installation through `use-package` and `straight.el`.

README badge

Report a problem