BRONZowl/codux.nvim

github

ai

7

0

1

0

CREATED

2026-06-13

UPDATED

2026-06-24

---

:CoduxWorkspaceCreate token-review
:CoduxWorkspaceCreate fix-tests --template debug
:CoduxWorkspaceCreate add-feature --template implementation
:CoduxWorkspaceCreate review-pr --template review

require("codux").setup({
  workspaces = {
    templates = {
      release = "You are working in a release workspace. Focus on verification, notes, and final checks.",
    },
  },
})

Manual Install

1. Add codux.nvim with lazy.nvim or LazyVim:

{
  "BRONZowl/codux.nvim",
  opts = {},
}

2. Run :Lazy sync, restart Neovim, then open Codux:

:Codux

In LazyVim, <leader> is usually Space. Codux also maps open to <leader>zc.

3. Install the Codex CLI and sign in if codex is not already available:

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex login

Confirm the CLI is available:

codex --version

4. Open a project and verify the setup:

cd ~/Projects/your-project
nvim

:checkhealth codux
:Codux

Requirements

• Neovim with terminal and floating window support
• OpenAI Codex CLI available as codex
• lazy.nvim or LazyVim

Optional:

• which-key.nvim for the <leader>z group label
• tmux for :CoduxWorkspaceCreate <name>
• Neo-tree, Oil.nvim, nvim-tree, or mini.files for file explorer targets

This plugin was developed using Neo-tree in LazyVim.

Windows users can use WSL2 with the Linux install command above, or follow the official Codex Windows setup guide.

For remote or headless login:

codex login --device-auth

Codux sends requested files, selections, diagnostics, and health output through your configured Codex CLI session.