nvim-context-ipc

让 Neovim 同时为 Codex CLI、Claude Code 和 DeepSeek Harness（dsh）提供 IDE context：当前文件、选区、打开的文件、workspace、diagnostics，以及可复用的文件操作和 native diff。

安装

以 lazy.nvim 为例：

{
  dir = "/home/sanzenin/test/nvim-context-ipc",
  name = "nvim-context-ipc",
  config = function()
    require("nvim_context_ipc").setup()
  end,
}

直接把仓库加入 runtimepath 时，plugin/nvim-context-ipc.lua 会自动启动默认配置。

默认行为

• Claude provider：监听 127.0.0.1 随机端口，写入 ~/.claude/ide/<port>.lock，自动发送选区更新；
• Codex provider：绑定 $CODEX_HOME/ipc/ipc.sock；陈旧且无法连接的 socket 会被安全清理，仍在使用的 socket 不会覆盖；
• 文件路径默认限制在当前 workspace；
• 文件打开、保存、diff 和关闭 tab 可用；
• executeCode 默认关闭，避免客户端执行任意代码；启用后优先使用 Jupyter kernel，没有 jupyter_client 时降级为持久 Python worker。
• 只读 stdio MCP bridge：bin/nvim-context-ipc-mcp，供需要显式 MCP 配置的 Codex/Claude 会话读取同一份内存快照。
• dsh IDE IPC：作为 client 连接独立的 dsh-ide-ipc 插件，Linux/macOS/WSL 默认使用 ~/.cache/nvim-context-ipc/dsh.sock，Windows 默认使用 \\.\pipe\dsh-ide-ipc；通过长连接注册 Neovim、workspace 和当前文件，并实时发送 context update。

配置

require("nvim_context_ipc").setup({
  permissions = {
    restrict_to_workspace = true,
    allow_file_writes = true,
    allow_open_file = true,
    allow_save_document = true,
    allow_open_diff = true,
    allow_close_tab = true,
    allow_execute_code = false,
  },
  claude = {
    port_min = 10000,
    port_max = 65535,
    -- expose_internal_tools = true, -- 暴露 close_tab
    -- python = "python3",
  },
  codex = {
    -- mode = "direct", -- 默认值
    -- socket_path = "~/.codex/ipc/ipc.sock",
  },
  dsh = {
    enabled = true,
    auto_start = true,
    -- socket_path = "~/.cache/nvim-context-ipc/dsh.sock",
  },
})

DeepSeek Harness（dsh）插件

先把独立的 dsh IDE IPC 插件安装到 dsh profile，再启动 Neovim：

dsh plugin --profile dsh-tui add github:wlz6/dsh-ide-ipc
dsh plugin --profile web add github:wlz6/dsh-ide-ipc

启动 profile 后，dsh 插件作为 socket server 注册 ide_list、ide_context、ide_open_file、ide_save_document 和 ide_open_diff。Nvim 作为长连接 client 主动注册并发送实时状态，工具请求仍受 Nvim 的 permissions 和 workspace 路径限制保护。多个 IDE 同时连接时，工具用 ide_id 或 workspace 路由。

两边需要使用相同 IPC 路径。Nvim 侧（Windows 可省略 socket_path 使用 named pipe 默认值）：

dsh = {
  socket_path = "~/.cache/nvim-context-ipc/dsh.sock",
  ide_name = "Neovim",
}

插件侧可用 DSH_IDE_IPC_SOCKET 或 profile 的 cordis.patch.yml 覆盖 config.socketPath。插件同时接入 dsh-tui status 和 dsh Web SSE 状态流，实时显示连接的 IDE 及当前文件。GitHub 安装时仍应只安装自己信任的仓库。

显式 MCP 配置

如果客户端不使用原生 IDE provider，可将下面的命令注册为只读 MCP：

codex mcp add nvim-context -- /home/sanzenin/test/nvim-context-ipc/bin/nvim-context-ipc-mcp
claude mcp add --scope user nvim-context -- /home/sanzenin/test/nvim-context-ipc/bin/nvim-context-ipc-mcp

Neovim 会将状态写入 ~/.cache/nvim-context-ipc/context.json，目录权限为 0700，状态文件权限为 0600。

已有 Codex router 或需要多个 Neovim 实例时，先启动：

/home/sanzenin/test/nvim-context-ipc/bin/nvim-context-ipc-router

再配置：

codex = {
  mode = "router",
  provider_socket = "~/.cache/nvim-context-ipc/providers.sock",
}

命令

:NvimContextStatus
:NvimContextPublish
:NvimContextDump
:NvimContextStart
:NvimContextStop
:NvimContextAcceptDiff [id]
:NvimContextRejectDiff [id]
:NvimContextAtMention [lineStart] [lineEnd]

启动顺序

1. 先启动 Neovim 并打开项目；
2. 在 Neovim 中确认 :NvimContextStatus 的 providers.claude.running、providers.codex.running 和 providers.dsh.running；
3. 通过 Neovim 的 ClaudeCode 窗口启动 Claude Code（配置已自动加入 --ide），或在现有 Claude 会话中重新运行 /ide；
4. 启动 Codex 后运行 /ide。

如果手动从 shell 启动 Claude Code，请使用 claude --ide。Codex 和 Neovim 必须运行在同一个 WSL 环境中。

插件更新后请先完全重启 Neovim 以加载新的 Lua 模块；运行期间仅需重连时，可执行 :NvimContextStop，再执行 :NvimContextStart，然后在 Claude 中重新运行 /ide。:NvimContextStatus 应显示 claude.clients=1。同一 workspace 同时只保留一个 Neovim IDE provider。

Claude 启动或重连时产生的短暂 ECONNRESET 属于 peer disconnect，插件会静默清理；只有其它非预期 WebSocket 错误才会显示通知。

Claude 工具

支持 openFile、openDiff、getCurrentSelection、getLatestSelection、getOpenEditors、getWorkspaceFolders、getDiagnostics、checkDocumentDirty、saveDocument、closeAllDiffTabs 和 executeCode。close_tab 默认隐藏，可通过 claude.expose_internal_tools = true 暴露。

保存 diff 右侧 buffer 返回 FILE_SAVED；关闭 diff 或执行 :NvimContextRejectDiff 返回 DIFF_REJECTED。

环境要求

• Neovim 0.10+（当前开发环境为 0.12.4）；
• Unix/WSL：Codex direct socket 和 router；
• Claude provider 需要支持 vim.uv/vim.loop 的 Neovim；
• dsh provider 作为 Unix domain socket 或 Windows Named Pipe client；Codex direct provider 仍只支持 Unix socket。
• executeCode 需要 Python；Jupyter kernel 需要 jupyter_client。

Codex IDE IPC 和 Claude IDE MCP 都属于目标客户端的私有/非稳定接口。使用 WSL 时，Neovim 与 Codex/Claude CLI 应运行在同一个 WSL 环境；跨 Windows/WSL 不会自动打通 Unix socket。