Open a file in a Neovim buffer and start its LSP client. Returns the buffer id, filetype, line count and attached LSP clients. Call this before LSP tools.

Read a file through Neovim with line numbers. Opens the file if needed. Use start_line and end_line to read a slice of a large file.

Replace lines start_line..end_line (1-based, inclusive) with new text. Saves the buffer by default, so format-on-save plugins run. Returns fresh LSP diagnostics for the file.

Replace an exact string in a file. Fails if the string is missing, or if it appears more than once and replace_all is false. Saves by default.

Insert text before the given line, 1-based. Use a line beyond the end to append. Saves by default.

Write a buffer to disk. BufWritePre autocommands run, so formatters and linters fire. Use this after edits made with save set to false.

List every loaded buffer with its path, filetype and modified state.

Get LSP errors and warnings for one file, or for every open buffer when path is omitted. Use this to check work after an edit.

Find where the symbol at a position is defined, through the LSP.

Find every reference to the symbol at a position, through the LSP. Use this before a rename or a signature change.

Get type and documentation information for the symbol at a position, the same text the editor shows on hover.

Rename a symbol across the whole workspace with the LSP, then save every changed file. Safer than a text search and replace.

List LSP code actions at a position. Pass apply_index to apply one and save the file. Use this to apply quick fixes for diagnostics.

Format a whole file or a line range with the formatter Neovim is configured to use, then save it.

List the symbol outline of a file: classes, functions and fields with their line numbers. Cheaper than reading the whole file.

Search symbols across the whole project through the LSP. Use this to find a definition by name without knowing the file.

Run a Lua chunk inside Neovim and return its value. The chunk receives its arguments through ... and must use return to send a value back. Use this to reach plugins that have no dedicated tool.

Run a Neovim Ex command, for example 'Telescope find_files' or 'Git blame', and return its output. Use this to drive installed plugins.