mg/FIELDNOTES

Editor guide / FROM THE WORKBENCH

Neovim: find, edit, inspect

The actual configured editing workflow: Telescope, Harpoon, language servers, formatting and Markdown.

Follow a small loop

Find a file, make a focused change, inspect diagnostics, format it, and run the relevant check. The editor shortens that loop; it does not establish that a change is correct.

The configured leader is Space. These mappings come from the published Neovim source , inspected alongside the local checkout.

ActionConfigured mappingTool
Find project filesSpace, s, fTelescope
Search file contentsSpace, s, gTelescope live grep
Remember a working fileSpace, aHarpoon
Open the remembered-file menuCtrl + eHarpoon
Format a bufferSpace, fConform
Move between editor splitsCtrl + h / j / k / lNeovim window navigation

Language support through Nix

The Neovim wrapper supplies language-server and formatter executables: gopls, TypeScript language server, nil, Pyright, clangd, Lua language server, Marksman and rust-analyzer among them. Formatting tools include Stylua, nixfmt, gofumpt, Black and Ruff.

This avoids depending on ordinary Linux binary downloads that may assume filesystem paths unavailable on NixOS. Plugin configuration and language-server behavior still need testing for the particular project.

Code and technical writing

The setup includes Treesitter grammars, Telescope, Harpoon, Conform and Markdown-oriented tooling. It supports moving between source code and technical notes while keeping tools close to the current buffer.

The Workbench’s browser editor demonstrates a deliberately small subset: h/j/k/l movement, i for insert, Escape for normal mode, x for deletion and u for undo. File switching retains each temporary buffer within the page. It is an interactive keyboard sketch of the workflow, with native browser controls available throughout.

Verification boundary

An actual headless Neovim startup succeeded on 16 October, and twelve selected language-server/formatter executables resolved inside its wrapped environment. That check does not certify every plugin, language server or debugger. The next deeper check is a representative edit/diagnostic/format/test journey for each language actually used on a client project.

← All The Workbench documentsBack to top ↑