NonGNU ELPA - codex-ide

• codex native integration for Emacs via Eat by default
  • Run Codex in a project-scoped terminal buffer.
  • Optionally use vterm when it is installed separately.
  • Resume, switch, cycle, and stop multiple live Codex sessions.
  • Optional IDE context provider and local Emacs MCP tools bridge.
• Requires Emacs 29.1 or newer.

• codex-ide-resume-session-scan-limit limits matching unique sessions offered by the picker (default 200), after filtering by project.
• If the project has no saved sessions, the picker offers other projects.
• Metadata lines larger than one MiB produce an explicit error.

• With Eat, C-c C-e enters its read-only Emacs mode for ordinary scrolling, movement, search, and selection.
• With vterm, use M-x vterm-copy-mode for transcript navigation.
• C-c C-j restores terminal input and jumps to the live Codex frame with either backend.

• With codex-ide-context-auto-start non-nil (default), new sessions enable the IDE context IPC automatically.
• Disable with (setq codex-ide-context-auto-start nil).

• Supports stateless MCP 2026-07-28 requests and the 2025-06-18 initialization flow for existing clients, on the same endpoint.
• Modern clients can discover capabilities with server/discover or call tools directly, with protocol metadata and matching routing headers.
• When codex-ide-mcp-enabled is non-nil (default), session start registers a transient local MCP URL via Codex -c overrides.
• The bridge can evaluate Elisp, edit buffers, and run shell commands. It exposes those control tools by default and only accepts loopback bind addresses.
• Commands: codex-ide-mcp-start, codex-ide-mcp-stop, codex-ide-mcp-status, codex-ide-mcp-install-codex-config.
• Structured edits require an explicit buffer name or open file path. Supplied tool arguments must match their advertised types; for example, positions are integers and indent is a JSON boolean.
• Default port is ephemeral (codex-ide-mcp-port 0). Persistent Codex config only stays reliable with a fixed port.
• Disable auto registration with (setq codex-ide-mcp-enabled nil).

Menu Save configuration persists the documented symbol set only (CLI/terminal/display/approval/YOLO/no-alt-screen/extra-args/config-overrides/ debug/MCP host-port-enable/context-auto-start).

Install vterm separately, then select it for new sessions:

(use-package vterm
  :ensure t)

(setq codex-ide-terminal-backend 'vterm)

Eat remains a required dependency and the default. Changing the option does not alter already running sessions.

See NEWS.org for release notes.

• Emacs 29.1 using package-vc-install

(unless (package-installed-p 'codex-ide)
  (package-vc-install
   '(codex-ide :url "https://git.thanosapollo.org/emacs-codex-ide"
               :lisp-dir "lisp")))

• Emacs 30 or newer using use-package :vc

(use-package codex-ide
  :vc (:url "https://git.thanosapollo.org/emacs-codex-ide"
       :lisp-dir "lisp"
       :rev :newest))

• Using straight.el

(straight-use-package
 '(codex-ide :type git
             :host nil
             :repo "https://git.thanosapollo.org/emacs-codex-ide"
             :files ("lisp/*.el" "LICENSE")))