code-preview.nvim

Review every edit your AI coding agent makes as a native Neovim diff — before it's written to disk.

Works with Claude Code, OpenCode, GitHub Copilot CLI, and OpenAI Codex CLI — on macOS, Linux, and Windows.

Demo

Shown with Claude Code. OpenCode, GitHub Copilot CLI, and Codex CLI work the same way — expand 📺 More demos below.

Why

Your AI coding agent proposes edits in its terminal — a cramped, scroll-past diff you have to eyeball before typing y. code-preview.nvim intercepts that moment and opens the proposed change as a real Neovim diff: full syntax highlighting, your colorscheme, your keymaps. Review it like any other diff, then accept or reject in the agent's CLI as usual.

• 🔍 See edits as native diffs — side-by-side or GitHub-style inline, before anything touches disk
• 🤝 Agent-agnostic — Claude Code, OpenCode, Copilot CLI, Codex CLI, with more agents planned
• 🌳 Neo-tree integration — your file tree marks what's being modified, created, or deleted
• 🪶 No Python — file transforms run through nvim --headless -l; the only hard dep is Neovim 0.10+

OpenCode

GitHub Copilot CLI

OpenAI Codex CLI

Neo-tree integration

Install

With lazy.nvim:

{
  "Cannon07/code-preview.nvim",
  config = function()
    require("code-preview").setup()
  end,
}

vim.opt.rtp:prepend("/path/to/code-preview.nvim")
require("code-preview").setup()

Requirements: Neovim >= 0.10. Each agent has a couple of extra needs — see below.

On Windows, the Copilot CLI hook runs under PowerShell 7+ and needs no jq.

Quick start

After setup(), the flow is the same for every agent:

1. Open your project in Neovim.
2. Install the agent's hooks (one command — pick your agent below) and restart that agent's CLI.
3. Ask the agent to edit a file — a diff preview opens automatically in Neovim.
4. Review it, then accept or reject in the agent. On accept, the preview closes automatically.

Then run the one install command for your agent (and apply any agent-specific config):

:CodePreviewInstallClaudeCodeHooks — writes hooks to .claude/settings.local.json. No extra config needed.

Permissions: by default the plugin forces a review prompt on every edit, so the preview always lines up with a real accept/reject moment — even if Claude Code is in bypass/allowlist mode. To instead let Claude Code's own permission settings decide, set diff.defer_claude_permissions = true (you'll then only see previews for edits Claude Code already stops to ask about).

:CodePreviewInstallOpenCodeHooks — copies the plugin to .opencode/plugins/.

Then enable permission prompts in ~/.config/opencode/opencode.json:

{ "permission": { "edit": "ask", "bash": "ask" } }

:CodePreviewInstallCopilotCliHooks — writes .github/hooks/code-preview.json. No extra config needed.

:CodePreviewInstallCodexCliHooks — writes .codex/hooks.json.

Codex must ask before applying edits, so set this in .codex/config.toml (or ~/.codex/config.toml):

approval_policy = "on-request"
sandbox_mode    = "read-only"

Without it, Codex may apply changes without prompting and the preview never blocks on your decision. Hooks are enabled by default in modern Codex; if you previously set [features] hooks = false (or the legacy codex_hooks = false), remove it. Codex routes file edits through apply_patch — files created via shell redirection (printf … > foo.txt) aren't previewed.

Rejected a change? The post-tool hook only fires on accept (and not at all on rejection for Claude Code & Copilot CLI), so press <leader>dq — or run :CodePreviewCloseDiff — to close the preview manually.

Supported agents

Every agent is first-class — same diff experience, same keymaps, same neo-tree indicators.

Each install command has a matching :CodePreviewUninstall… counterpart. More agents are planned.

Configuration

setup() works with zero config. The most common knob is the diff layout:

require("code-preview").setup({
  diff = {
    layout = "tab",  -- "tab" | "vsplit" | "inline"
  },
})

You can also set the layout per agent — e.g. inline for Codex, a tab for everything else:

require("code-preview").setup({
  diff = {
    layout  = "tab",                 -- default for all agents
    layouts = { codex = "inline" },  -- keys: claudecode | opencode | copilot | codex
  },
})

A fuller example

A realistic, opinionated lazy.nvim spec — inline diffs everywhere, a per-agent override, and neo-tree revealing from the git root:

{
  "Cannon07/code-preview.nvim",
  event = "VeryLazy",
  config = function()
    require("code-preview").setup({
      diff = {
        layout  = "inline",              -- unified GitHub-style diff (the strategic default)
        layouts = { opencode = "tab" },  -- override the layout per agent, to taste
      },
      neo_tree = { reveal_root = "git" }, -- reveal from the git root instead of cwd
    })
  end,
}

Full option reference: :help code-preview-config (or doc/code-preview.txt) — every option, with the defaults kept in sync with the source.

See :help code-preview-commands and :help code-preview-keymaps for details.

Neo-tree integration (optional)

If you use neo-tree.nvim, code-preview decorates your file tree with indicators whenever changes are pending — no extra config, it works out of the box. If neo-tree isn't installed, nothing changes.

Plus: auto-reveal of the changed file, virtual nodes for not-yet-created files, a temporarily clean focus (git status/diagnostics hidden while a change is pending), and auto-cleanup on accept/reject/<leader>dq. Symbols, colors, position, and reveal behavior are all configurable under the neo_tree table — see :help code-preview-config.

How it works

AI Agent (terminal)