codex.nvim

A lightweight Neovim plugin that opens OpenAI Codex CLI in a side terminal split with context sending.

Requirements

• Neovim >= 0.10.0
• Codex CLI installed and on your PATH

Installation

lazy.nvim

{
  "jcarlos7121/codex.nvim",
  config = function()
    require("codex").setup()
  end,
  keys = {
    { "<leader>cx", "<cmd>Codex<cr>", desc = "Toggle Codex" },
    { "<leader>cs", ":<C-u>CodexSend<cr>", mode = "v", desc = "Send selection to Codex" },
    { "<leader>cf", "<cmd>CodexSendFile<cr>", desc = "Send file path to Codex" },
  },
}

Configuration

require("codex").setup({
  terminal_cmd = "codex",           -- Codex CLI binary path
  split_side = "right",             -- "right", "left", "bottom", "top"
  split_width_percentage = 40,      -- % of screen width/height
  auto_close = true,                -- Close terminal buffer on process exit
})

Commands

Command	Description
:Codex	Toggle terminal
:CodexOpen	Open terminal
:CodexClose	Close terminal (keep process)
:CodexFocus	Focus terminal window
:CodexSend	Send visual selection to terminal
:CodexSendFile	Send current file path to terminal