Skip to content

User Guide

timvim is a batteries-included Neovim built declaratively with Nix. Out of the box you get language servers, formatting on save, fuzzy finding, a full git workflow, AI assistance and a Kartoza-branded interface — all driven by a consistent, discoverable set of keybindings.

The leader key is Space. Press it and pause to let which-key show you every available group and action, so you rarely need to memorise anything.

Discoverability first

Every top-level group (Space a, Space g, Space l …) is labelled with an icon and description in the which-key popup. When in doubt, press Space and read.

Explore the guide

  • Editing — Motions, surround, Flash jumps, mini.nvim niceties, format-on-save and spell checking. Read

  • Completion & AI — blink-cmp completion, Copilot ghost text and Claude Code integration. Read

  • Navigation — Telescope, FZF, projects, sessions, splits, Yazi and the code outline. Read

  • Git — Gitsigns, Diffview, conflict resolution, Octo for GitHub and inline blame. Read

  • LSP — Diagnostics, hover, code actions, Trouble, Harper grammar and per-language servers. Read

  • Debugging — DAP breakpoints, stepping and the debug UI. Read

  • Refactoring — Extract and inline functions, variables and blocks. Read

  • Terminal & Files — Toggleterm and the Yazi file manager. Read

  • Image Preview — In-editor images via the Kitty graphics protocol. Read