claudinho-nvim 0.2.0

package/README.md

@@ -0,0 +1,56 @@
+# claudinho-nvim
+
+Most plugins for claude code in neovim are really just one single thing, they run claude code inside of a terminal session. I find this bad for two of reasons personally:
+- The terminal buffer is not as capable as actual terminal, or even as tmux
+- Having to write some command to mention code in Claude Code is not a very good expereicen, and then you need yet another shortcut
+
+So this is Opus's attempt at a better experience for this. It includes a Claude Code plugin that can be installed, and it will communicate with the neovim plugin. The neovim plugin will exist as a tool that Claude can access whatever is the state of your neovim. That means, splits, buffers open, selection, draft code, etc.
+
+This is borrowing from the idea that [amp.nvim](https://github.com/sourcegraph/amp.nvim) implements, which I believe is now discontinued, and it was used as a basis for this project.
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `nvim_get_buffers` | List all open buffers with path, modified status, and which is current |
+| `nvim_get_buffer_content` | Read lines from a buffer (defaults to current buffer) |
+| `nvim_get_cursor` | Get cursor position, current file, and Vim mode |
+| `nvim_get_window_layout` | Get all windows/splits with their buffers and dimensions |
+| `nvim_get_visual_selection` | Get the last visual selection text and range |
+| `nvim_get_diagnostics` | Get LSP diagnostics, optionally filtered by buffer or severity |
+
+## Setup
+
+Install dependencies and build:
+
+```sh
+pnpm install
+pnpm build
+```
+
+Add to your Claude Code settings (`~/.claude.json`):
+
+```json
+{
+  "mcpServers": {
+    "claudinho": {
+      "command": "npx -y",
+      "args": ["claudinho-nvim"]
+    }
+  }
+}
+```
+
+Claude Code must be launched from a Neovim `:terminal` so the `$NVIM` environment variable is available.
+
+## Development
+
+```sh
+pnpm start        # run from source with tsx
+pnpm build        # bundle into dist/index.js
+pnpm typecheck    # type check without emitting
+pnpm lint         # run biome linter
+pnpm lint:fix     # auto-fix lint issues
+pnpm version      # bump version from changesets
+pnpm release      # build and publish to npm
+```

package/dist/index.js

@@ -0,0 +1,242 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { attach } from "neovim";
+//#region src/nvim-client.ts
+let client = null;
+function getNvimClient() {
+	if (client) return client;
+	const socketPath = process.env.NVIM;
+	if (!socketPath) throw new Error("$NVIM environment variable not set. Claude Code must be running inside a Neovim terminal.");
+	client = attach({ socket: socketPath });
+	return client;
+}
+//#endregion
+//#region src/tools/buffers.ts
+function registerBufferTools(server) {
+	server.registerTool("nvim_get_buffers", { description: "List all open buffers in Neovim with metadata" }, async () => {
+		const nvim = getNvimClient();
+		const buffers = await nvim.buffers;
+		const currentBuf = await nvim.buffer;
+		const result = await Promise.all(buffers.map(async (buf) => {
+			const [name, loaded, modified] = await Promise.all([
+				buf.name,
+				buf.loaded,
+				nvim.call("getbufvar", [buf.id, "&modified"])
+			]);
+			return {
+				bufnr: buf.id,
+				name,
+				loaded,
+				modified: modified === 1,
+				current: buf.id === currentBuf.id
+			};
+		}));
+		return { content: [{
+			type: "text",
+			text: JSON.stringify(result, null, 2)
+		}] };
+	});
+	server.registerTool("nvim_get_buffer_content", {
+		description: "Get the content of a buffer. Defaults to the current buffer.",
+		inputSchema: {
+			bufnr: z.number().optional().describe("Buffer number. Omit for current buffer."),
+			startLine: z.number().optional().describe("Start line (0-indexed, inclusive)"),
+			endLine: z.number().optional().describe("End line (0-indexed, exclusive)")
+		}
+	}, async ({ bufnr, startLine, endLine }) => {
+		const nvim = getNvimClient();
+		const buf = bufnr ? (await nvim.buffers).find((b) => b.id === bufnr) : await nvim.buffer;
+		if (!buf) return {
+			content: [{
+				type: "text",
+				text: `Buffer ${bufnr} not found`
+			}],
+			isError: true
+		};
+		const [name, lines] = await Promise.all([buf.name, buf.getLines({
+			start: startLine ?? 0,
+			end: endLine ?? -1,
+			strictIndexing: false
+		})]);
+		return { content: [{
+			type: "text",
+			text: JSON.stringify({
+				bufnr: buf.id,
+				name,
+				totalLines: lines.length,
+				lines
+			}, null, 2)
+		}] };
+	});
+}
+//#endregion
+//#region src/tools/cursor.ts
+function registerCursorTools(server) {
+	server.registerTool("nvim_get_cursor", { description: "Get the current cursor position, file, and Vim mode" }, async () => {
+		const nvim = getNvimClient();
+		const [win, mode] = await Promise.all([nvim.window, nvim.mode]);
+		const [buf, cursor] = await Promise.all([win.buffer, win.cursor]);
+		const name = await buf.name;
+		return { content: [{
+			type: "text",
+			text: JSON.stringify({
+				bufnr: buf.id,
+				file: name,
+				line: cursor[0],
+				col: cursor[1],
+				mode: mode.mode
+			}, null, 2)
+		}] };
+	});
+	server.registerTool("nvim_get_window_layout", { description: "Get all windows/splits with their buffers, cursor positions, and dimensions" }, async () => {
+		const windows = await getNvimClient().windows;
+		const result = await Promise.all(windows.map(async (win) => {
+			const [buf, cursor, height, width, position] = await Promise.all([
+				win.buffer,
+				win.cursor,
+				win.height,
+				win.width,
+				win.position
+			]);
+			const name = await buf.name;
+			return {
+				windowId: win.id,
+				bufnr: buf.id,
+				file: name,
+				cursor: {
+					line: cursor[0],
+					col: cursor[1]
+				},
+				height,
+				width,
+				position: {
+					row: position[0],
+					col: position[1]
+				}
+			};
+		}));
+		return { content: [{
+			type: "text",
+			text: JSON.stringify(result, null, 2)
+		}] };
+	});
+}
+//#endregion
+//#region src/tools/diagnostics.ts
+const SEVERITY_MAP = {
+	error: 1,
+	warn: 2,
+	info: 3,
+	hint: 4
+};
+const SEVERITY_NAMES = [
+	"",
+	"error",
+	"warn",
+	"info",
+	"hint"
+];
+const GET_DIAGNOSTICS_LUA = `
+local bufnr, severity = ...
+if bufnr == 0 then bufnr = nil end
+if severity == 0 then severity = nil end
+local opts = {}
+if severity then opts.severity = severity end
+local diags = vim.diagnostic.get(bufnr, opts)
+local results = {}
+for _, d in ipairs(diags) do
+  table.insert(results, {
+    bufnr = d.bufnr,
+    file = vim.api.nvim_buf_get_name(d.bufnr),
+    line = d.lnum + 1,
+    col = d.col + 1,
+    message = d.message,
+    severity = d.severity,
+    source = d.source or "",
+  })
+end
+return vim.json.encode(results)
+`;
+function registerDiagnosticsTools(server) {
+	server.registerTool("nvim_get_diagnostics", {
+		description: "Get LSP diagnostics (errors, warnings, etc.) for a buffer or all buffers",
+		inputSchema: {
+			bufnr: z.number().optional().describe("Buffer number. Omit for all buffers."),
+			severity: z.enum([
+				"error",
+				"warn",
+				"info",
+				"hint"
+			]).optional().describe("Filter by severity level")
+		}
+	}, async ({ bufnr, severity }) => {
+		const nvim = getNvimClient();
+		const severityNum = severity ? SEVERITY_MAP[severity] : 0;
+		const raw = await nvim.lua(GET_DIAGNOSTICS_LUA, [bufnr ?? 0, severityNum]);
+		const result = JSON.parse(raw).map((d) => ({
+			...d,
+			severity: SEVERITY_NAMES[d.severity] || String(d.severity)
+		}));
+		return { content: [{
+			type: "text",
+			text: JSON.stringify(result, null, 2)
+		}] };
+	});
+}
+//#endregion
+//#region src/tools/selection.ts
+const GET_SELECTION_LUA = `
+local buf = vim.api.nvim_get_current_buf()
+local start_pos = vim.fn.getpos("'<")
+local end_pos = vim.fn.getpos("'>")
+
+if start_pos[2] == 0 and end_pos[2] == 0 then
+  return vim.json.encode({ hasSelection = false })
+end
+
+local start_line = start_pos[2] - 1
+local start_col = start_pos[3] - 1
+local end_line = end_pos[2] - 1
+local end_col = end_pos[3]
+
+local lines = vim.api.nvim_buf_get_text(buf, start_line, start_col, end_line, end_col, {})
+local name = vim.api.nvim_buf_get_name(buf)
+
+return vim.json.encode({
+  hasSelection = true,
+  bufnr = buf,
+  file = name,
+  startLine = start_pos[2],
+  startCol = start_pos[3],
+  endLine = end_pos[2],
+  endCol = end_pos[3],
+  text = table.concat(lines, "\\n"),
+})
+`;
+function registerSelectionTools(server) {
+	server.registerTool("nvim_get_visual_selection", { description: "Get the current or last visual selection text and range" }, async () => {
+		const raw = await getNvimClient().lua(GET_SELECTION_LUA, []);
+		const result = JSON.parse(raw);
+		return { content: [{
+			type: "text",
+			text: JSON.stringify(result, null, 2)
+		}] };
+	});
+}
+//#endregion
+//#region src/index.ts
+const server = new McpServer({
+	name: "claudinho",
+	version: "0.1.0"
+});
+registerBufferTools(server);
+registerCursorTools(server);
+registerSelectionTools(server);
+registerDiagnosticsTools(server);
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error("claudinho MCP server running");
+//#endregion
+export {};

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "claudinho-nvim",
+  "version": "0.2.0",
+  "description": "Claude Code MCP plugin for Neovim integration",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gabrielmfern/claudinho.git"
+  },
+  "homepage": "https://github.com/gabrielmfern/claudinho",
+  "bugs": {
+    "url": "https://github.com/gabrielmfern/claudinho/issues"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": "dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.29.0",
+    "neovim": "5.4.0",
+    "zod": "3.25.76"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.4.10",
+    "@changesets/changelog-github": "0.6.0",
+    "@changesets/cli": "2.30.0",
+    "@types/node": "25.5.2",
+    "tsdown": "0.21.7",
+    "tsx": "4.21.0",
+    "typescript": "6.0.2"
+  },
+  "scripts": {
+    "start": "tsx src/index.ts",
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check src",
+    "lint:fix": "biome check --write src",
+    "version": "changeset version",
+    "release": "pnpm build && changeset publish"
+  }
+}