Neovim

Neovim is the default editor (EDITOR=nvim). The module lives in modules/home/neovim/ and is imported by the development profile, so Asgard, Niflheim, and the templates all get the same setup.

Ownership: Nix installs, Lua configuresCopy Anchor Link

There is no plugin manager such as Lazy.nvim, packer, or Mason, and nothing is downloaded when Neovim starts.

• Nix (default.nix) owns the runtime surface. programs.neovim.plugins declares every plugin and every Tree-sitter grammar. programs.neovim.extraPackages puts language servers, formatters, debuggers, search tools, and the Claude Code CLI on Neovim's PATH. Most of these come from the shared editor tools list.
• Lua (configs/init.lua and configs/lua/) configures what Nix installed. Home Manager links both into ~/.config/nvim as read-only store paths.

Adding a Lua require for a plugin that is not declared in Nix makes start-up fail, so a new plugin, parser, server, or formatter is always added to default.nix first. Plugins missing from the pinned nixpkgs (NeoJJ, codedocs, neo-tree file-nesting rules, and the theme plugins) are built locally from pinned sources.

The Python and Ruby providers are disabled. CONFIG_THEME_FAMILY is exported from the shared theme settings so the Lua side picks the matching colour scheme.

Start-up orderCopy Anchor Link

Start-up is eager and ordered:

config.globals.setup()      leaders and capability flags
options
keymap
autocmds
languages.setup()           filetype behaviour
plugins.setup()             explicit, ordered plugin groups
config.theme.set_colorscheme()

The colour scheme is applied last because applying one clears the highlight groups that Heirline and other UI plugins generate. Within the plugin groups, leaders exist before any mappings, Mini Icons provides nvim-web-devicons compatibility before its consumers load, VCS state is ready before the statusline reads it, and Blink and LazyDev initialise before the LSP configuration requests their capabilities.

Editing featuresCopy Anchor Link

InterfaceCopy Anchor Link

• Heirline draws the global statusline, including Git or jj diff counters.
• Telescope (Ivy layout) handles files, search, buffers, and LSP pickers. Its project root is the nearest .jj or .git directory.
• Neo-tree shows the file system, buffers, Git status, and symbols, with file nesting and current-file following.
• Snacks provides input, picker, and terminal windows.
• Mini adds text objects, surrounds, pairs, indent scope, icons, and animation. Cursor animation and the cursor line are disabled in terminal buffers because they made typing in TUIs lag.
• Which-key shows the leader groups. Bindings follow Doom Emacs.
• Dropbar, Outline, Trouble, todo-comments, render-markdown, and nvim-highlight-colors round out the UI.
• Auto Dark Mode switches between the light and dark variant of the theme with the system appearance.

Leader groupsCopy Anchor Link

The leader is Space; the local leader is ,.

Version controlCopy Anchor Link

Repository actions use NeoJJ in a jj repository and Neogit in a plain Git repository. A colocated repository counts as jj, because .jj wins. The VCS layer detects the root asynchronously, caches diff counters for the statusline (unstaged tracked changes for Git, the working-copy commit @ for jj), and dispatches the shared actions:

The same actions are available as :Vcs [action]. Gitsigns hunk operations live under <leader>gh, for example <leader>ghp to preview, <leader>ghs to stage, and <leader>ghr to revert a hunk. diffs.nvim adds syntax-aware and intra-line diff highlighting to Neogit, NeoJJ, Gitsigns previews, Telescope previews, and conflict markers. Its own :Diff command only understands Git, so the portable entry point is <leader>gd.

Claude CodeCopy Anchor Link

claudecode.nvim runs the Claude Code CLI in a right-side Snacks terminal and exposes the editor's context (open files, selections, diagnostics) through its IDE bridge. The terminal is focused and in insert mode as soon as it opens, and the leader mappings that open terminals are normal-mode only so typing into Claude Code cannot trigger them.

Avante is still declared and configured as an inactive alternative; its setup is disabled.

Validating changesCopy Anchor Link

The installed nvim runs the last activated configuration. To test edits in the checkout, load it explicitly:

CONFIG_THEME_FAMILY=meowsoot \
nvim -n --headless \
  --cmd "set runtimepath^=$PWD/modules/home/neovim/configs" \
  -u "$PWD/modules/home/neovim/configs/init.lua" \
  '+qa'

When plugins or executables changed, build a Home Manager generation first and add its pack directory with --cmd "set packpath^=..."; the exact command is in AGENTS.md. Format changed Lua with stylua.