Report the connected Neovim instance: version, channel, working directory, current buffer/window and how the connection was resolved. Use this first to confirm the agent is wired to a live Neovim.

Run Lua in Neovim via nvim_exec_lua and return the result as JSON. The code is a function body, so use return to produce a value and reference call arguments via .... This is the most powerful tool: anything the Neovim Lua API can do is reachable here.

Execute an Ex command (e.g. :write, :bnext, :vsplit foo.txt) and return its captured output.

Evaluate a Vimscript expression (e.g. expand('%:p')) and return the result.

List all buffers with their number, name, type, modified state and line count. Terminal buffers report buftype 'terminal'.

Read lines from a buffer (by number, path, or the current buffer). Line range is 0-based and end-exclusive; end = -1 reads to the end.

Replace a line range in a buffer with new lines. Line range is 0-based and end-exclusive; use start = 0, end = -1 to replace the whole buffer.

Open a file in Neovim, optionally in a split or new tab, and return its buffer info.

List open windows with their buffer, size and cursor position.

Return LSP/diagnostic entries (errors, warnings, etc.) for a buffer, or for all buffers if none is given. Great for letting the agent see and fix problems the way Cursor does.

Open a terminal inside Neovim, run a single shell command, wait for it to finish, and return its output and exit code. This is the one-shot building block: e.g. run echo hello world and read it back. The terminal runs inside the user's editor, so the command shares the editor's environment and working directory.

Open a persistent terminal inside Neovim and return its buffer number, channel and job id. Use nvim_terminal_send to type into it and nvim_terminal_read to read its screen. Use this for interactive or long-running sessions; for one-shot commands prefer nvim_run_in_terminal.

List terminal buffers currently open in Neovim, with their job/channel and running state.

Send input to an open terminal buffer. By default a carriage return is appended so the line is submitted; set enter=false to send raw keys (e.g. control characters).

Read the rendered contents (scrollback + current screen) of a terminal buffer. Trailing blank lines are trimmed by default.

List the language servers attached to a buffer (or the current buffer), with their id, name, root directory and whether they have finished initializing. Use this to check language intelligence is available before calling the other nvim_lsp_* tools.

Get hover documentation (signatures, types, docs) for the symbol at a position, as the editor's language server would show it.

Resolve the definition location(s) of the symbol at a position. Returns file, line and column (1-based) for each location.

Find all references to the symbol at a position across the project.

List the symbols (functions, classes, variables, …) defined in a buffer, with their kind and line. Nesting is reported via depth.

Rename the symbol at a position project-wide via the language server and apply the resulting edits (set apply=false to preview which files would change without modifying anything).

List the code actions (quick fixes, refactors) the language server offers at a position, including any diagnostics there. Pass applyIndex (1-based, from a previous listing) to apply one of them.

Format a buffer using its language server and apply the changes in place.