Skip to content

NEOVIM_KEYMAP.md

Latest commit

 

History

History
748 lines (617 loc) · 24.9 KB

NEOVIM_KEYMAP.md

File metadata and controls

748 lines (617 loc) · 24.9 KB

Neovim LazyVim Keymap Reference

Comprehensive keymap documentation for LazyVim configuration with custom plugins

Leader Key: <Space> (Space bar) Local Leader Key: \

Table of Contents

  1. Core Navigation & Movement
  2. Window Management
  3. Buffer Management
  4. File Operations
  5. Search & Navigation
  6. Code Editing
  7. LSP (Language Server Protocol)
  8. Diagnostics
  9. Git Operations
  10. Formatting & Toggles
  11. Terminal
  12. Snacks Picker
  13. Telescope
  14. Claude Code (AI Assistant)
  15. Trouble (Diagnostics)
  16. TODO Comments
  17. Neo-tree (File Explorer)
  18. DAP (Debugging)
  19. Neotest (Testing)
  20. Mini Plugins
  21. Mason (LSP Installer)
  22. Tabs
  23. Quickfix & Location List
  24. LazyVim UI

Core Navigation & Movement

Basic Movement

Key Mode Description
j n, x Down (better down with gj when no count)
k n, x Up (better up with gk when no count)
<Down> n, x Down (same as j)
<Up> n, x Up (same as k)
<C-h> n Move to left window
<C-j> n Move to lower window
<C-k> n Move to upper window
<C-l> n Move to right window

Line Movement

Key Mode Description
<A-j> n, i, v Move current line down
<A-k> n, i, v Move current line up

Visual Selection Movement (Mini.move)

Key Mode Description
<A-h> v Move selection left
<A-j> v Move selection down
<A-k> v Move selection up
<A-l> v Move selection right

Flash Navigation

Key Mode Description
s n, x, o Flash jump
S n, x, o Flash Treesitter
r o Remote Flash
R o, x Treesitter Search
<C-s> c Toggle Flash Search (in command mode)
<C-Space> n, o, x Treesitter Incremental Selection

Window Management

Window Navigation

Key Mode Description
<C-h> n Move to left window
<C-j> n Move to lower window
<C-k> n Move to upper window
<C-l> n Move to right window

Window Resizing

Key Mode Description
<C-Up> n Increase window height by 2
<C-Down> n Decrease window height by 2
<C-Left> n Decrease window width by 2
<C-Right> n Increase window width by 2

Window Operations

Key Mode Description
<leader>- n Split window horizontally
<leader>| n Split window vertically
<leader>wd n Delete window
<leader>wm n Toggle window zoom
<leader>uZ n Toggle window zoom (alternate)
<C-w><Space> n Window Hydra Mode (which-key)

Buffer Management

Key Mode Description Command
<S-h> n Previous buffer :bprevious
<S-l> n Next buffer :bnext
[b n Previous buffer (alternate) :bprevious
]b n Next buffer (alternate) :bnext
[B n Move buffer prev -
]B n Move buffer next -
<leader>bb n Switch to other buffer :e #
``` n Switch to other buffer (alternate) :e #
<leader>bd n Delete buffer :lua Snacks.bufdelete()
<leader>bo n Delete other buffers :lua Snacks.bufdelete.other()
<leader>bD n Delete buffer and window :bd
<leader>bl n Delete buffers to the left -
<leader>br n Delete buffers to the right -
<leader>bp n Toggle pin -
<leader>bP n Delete non-pinned buffers -
:bd command Delete buffer (aliased to Snacks.bufdelete) :BD

File Operations

Key Mode Description
<C-s> n, i, x, s Save file
<leader>fn n New file

Search & Navigation

Key Mode Description
<Esc> i, n, s Clear search and stop snippet
<leader>ur n Redraw, clear search, diff update
n n, x, o Next search result (centered)
N n, x, o Previous search result (centered)
<leader>sr n, x Search and Replace (grug-far)

Code Editing

Basic Editing

Key Mode Description
<leader>K n Keywordprg lookup
< x Decrease indent (maintains selection)
> x Increase indent (maintains selection)
gco n Add comment below line
gcO n Add comment above line

Undo Break-points

Key Mode Description
, i Add undo break-point
. i Add undo break-point
; i Add undo break-point

Surround Operations (Mini.surround)

Key Mode Description
gsa n, x Add surrounding
gsd n Delete surrounding
gsf n Find surrounding (to the right)
gsF n Find surrounding (to the left)
gsh n Highlight surrounding
gsr n Replace surrounding
gsn n Update n_lines configuration

LSP (Language Server Protocol)

Navigation

Key Mode Description Command
gd n Goto Definition :lua vim.lsp.buf.definition()
gD n Goto Declaration :lua vim.lsp.buf.declaration()
gr n References :lua vim.lsp.buf.references()
gi n Goto Implementation (custom override) :lua vim.lsp.buf.implementation()
gI n Goto Implementation (LazyVim default) :lua vim.lsp.buf.implementation()
gt n Goto Type Definition (custom override) :lua vim.lsp.buf.type_definition()
gy n Goto Type Definition (LazyVim default) :lua vim.lsp.buf.type_definition()
]] n Next Reference -
[[ n Prev Reference -
<A-n> n Next Reference (alternate) -
<A-p> n Prev Reference (alternate) -
gai n Calls Incoming -
gao n Calls Outgoing -

Documentation & Help

Key Mode Description Command
K n Hover documentation :lua vim.lsp.buf.hover()
gK n Signature Help :lua vim.lsp.buf.signature_help()
<C-k> n Signature Help (custom) :lua vim.lsp.buf.signature_help()
<C-k> i Signature Help (LazyVim default) :lua vim.lsp.buf.signature_help()

Code Actions

Key Mode Description Command
<leader>ca n, x Code Action (LazyVim default) :lua vim.lsp.buf.code_action()
<leader>Ca n, v Code Action (custom LSP binding) :lua vim.lsp.buf.code_action()
<D-.> n, v Code Action (macOS - Cmd+.) :lua vim.lsp.buf.code_action()
<leader>cA n Source Action -
<leader>cr n Rename symbol (LazyVim default) :lua vim.lsp.buf.rename()
<leader>rn n Rename symbol (custom) :lua vim.lsp.buf.rename()
<leader>cR n Rename File -
<leader>cf n, x Format code (LazyVim default) -
<leader>cF n, x Format Injected Langs -
<leader>f n Format code (custom async) :lua vim.lsp.buf.format({async=true})

Code Lens

Key Mode Description Command
<leader>cc n, x Run Codelens :lua vim.lsp.codelens.run()
<leader>cC n Refresh & Display Codelens :lua vim.lsp.codelens.refresh()

LSP Management

Key Mode Description Command
<leader>cl n LSP Info :LspInfo
<leader>cm n Mason (LSP installer) :Mason
<leader>wa n Add workspace folder :lua vim.lsp.buf.add_workspace_folder()
<leader>wr n Remove workspace folder :lua vim.lsp.buf.remove_workspace_folder()
<leader>wl n List workspace folders -

Diagnostics

Key Mode Description Command
<leader>cd n Show line diagnostics :lua vim.diagnostic.open_float()
<leader>ud n Toggle diagnostics -
]d n Next diagnostic :lua vim.diagnostic.goto_next()
[d n Previous diagnostic :lua vim.diagnostic.goto_prev()
]e n Next error -
[e n Previous error -
]w n Next warning -
[w n Previous warning -

Git Operations

Git Commands

Key Mode Description
<leader>gg n Lazygit (root directory)
<leader>gG n Lazygit (current working directory)
<leader>gL n Git log (cwd)
<leader>gl n Git log
<leader>gf n Git history for current file
<leader>gb n Git log for current line (Snacks picker)
<leader>gB n, x Git browse (open in browser)
<leader>gY n, x Copy git browser URL
<leader>gd n Git Diff (hunks)
<leader>gD n Git Diff (origin)
<leader>gs n Git Status
<leader>gS n Git Stash
<leader>gi n GitHub Issues (open)
<leader>gI n GitHub Issues (all)
<leader>gp n GitHub Pull Requests (open)
<leader>gP n GitHub Pull Requests (all)

Git Hunks (Gitsigns)

Key Mode Description
]h n Next hunk
[h n Previous hunk
]H n Last hunk
[H n First hunk
<leader>ghs n, x Stage hunk
<leader>ghr n, x Reset hunk
<leader>ghS n Stage buffer
<leader>ghu n Undo stage hunk
<leader>ghR n Reset buffer
<leader>ghp n Preview hunk inline
<leader>ghb n Blame line
<leader>ghB n Blame buffer
<leader>ghd n Diff this
<leader>ghD n Diff this ~
ih o, x GitSigns Select Hunk
<leader>uG n Toggle Git Signs

Formatting & Toggles

Formatting

Key Mode Description
<leader>cf n, x Format code
<leader>uf n Toggle auto-format (global)
<leader>uF n Toggle auto-format (buffer)

UI Toggles

Key Mode Description
<leader>us n Toggle spelling
<leader>uw n Toggle line wrap
<leader>uL n Toggle relative line numbers
<leader>ul n Toggle line numbers
<leader>ud n Toggle diagnostics
<leader>uc n Toggle conceal level
<leader>uA n Toggle tabline
<leader>uT n Toggle treesitter highlight
<leader>ub n Toggle dark background
<leader>uD n Toggle dimming
<leader>ua n Toggle animations
<leader>ug n Toggle indent guides
<leader>uS n Toggle smooth scroll
<leader>uh n Toggle inlay hints
<leader>uz n Toggle zen mode
<leader>uZ n Toggle zoom mode
<leader>uC n Colorschemes
<leader>un n Dismiss all notifications

Profiler Toggles

Key Mode Description
<leader>dpp n Toggle Profiler
<leader>dph n Toggle Profiler Highlights
<leader>dps n Profiler Scratch Buffer

Terminal

Key Mode Description Command
<C-t> n, t Toggle terminal (ToggleTerm) :ToggleTerm
<C-\>` n, t Toggle terminal (ToggleTerm alternate) :ToggleTerm
<C-/> n, t Toggle terminal (root directory) :lua Snacks.terminal()
<C-_> n, t Toggle terminal (alternate binding) :lua Snacks.terminal()
<leader>fT n Terminal at current working directory -
<leader>ft n Terminal at root -

Snacks Picker

Snacks is the default picker (configured via vim.g.lazyvim_picker = "snacks").

File Finding

Key Mode Description
<leader><space> n Find Files (Root Dir)
<leader>ff n Find Files (Root Dir)
<leader>fF n Find Files (cwd)
<leader>fg n Find Files (git-files)
<leader>fr n Recent files
<leader>fR n Recent files (cwd)
<leader>fc n Find Config File
<leader>fp n Projects

Buffers

Key Mode Description
<leader>, n Buffers
<leader>fb n Buffers
<leader>fB n Buffers (all)

Search

Key Mode Description
<leader>/ n Grep (Root Dir)
<leader>sg n Grep (Root Dir)
<leader>sG n Grep (cwd)
<leader>sw n, x Visual selection or word (Root Dir)
<leader>sW n, x Visual selection or word (cwd)
<leader>sb n Buffer Lines
<leader>sB n Grep Open Buffers

Misc Search

Key Mode Description
<leader>: n Command History
<leader>sc n Command History
<leader>sC n Commands
<leader>s" n Registers
<leader>s/ n Search History
<leader>sa n Autocmds
<leader>sd n Diagnostics
<leader>sD n Buffer Diagnostics
<leader>sh n Help Pages
<leader>sH n Highlights
<leader>si n Icons
<leader>sj n Jumps
<leader>sk n Keymaps
<leader>sl n Location List
<leader>sm n Marks
<leader>sM n Man Pages
<leader>sp n Search for Plugin Spec
<leader>sq n Quickfix List
<leader>sR n Resume
<leader>su n Undotree
<leader>ss n LSP Symbols
<leader>sS n LSP Workspace Symbols

Notifications & Scratch

Key Mode Description
<leader>n n Notification History
<leader>. n Toggle Scratch Buffer
<leader>S n Select Scratch Buffer

Telescope

Telescope is installed for plugin compatibility but Snacks picker is the default. No custom keybindings are defined.

To use Telescope directly, you can call commands manually:

Command Description
:Telescope find_files Find files
:Telescope live_grep Live grep
:Telescope buffers Show buffers
:Telescope help_tags Show help tags

Claude Code (AI Assistant)

Uses LazyVim's default <leader>a prefix for all AI operations.

Main Commands

Key Mode Description
<leader>ac n Toggle Claude
<leader>af n Focus Claude
<leader>ar n Resume Claude
<leader>aC n Continue Claude

File Management

Key Mode Description
<leader>ab n Add current buffer
<leader>as v Send selection to Claude
<leader>as n (file explorer) Add file from tree

Diff Management

Key Mode Description
<leader>aa n Accept diff
<leader>ad n Deny diff

Trouble (Diagnostics)

Key Mode Description Command
<leader>xx n Diagnostics (Trouble) :Trouble diagnostics toggle
<leader>xX n Buffer Diagnostics :Trouble diagnostics toggle filter.buf=0
<leader>cs n Symbols (Trouble) :Trouble symbols toggle
<leader>cS n LSP references/definitions/... (Trouble) :Trouble lsp toggle
<leader>xL n Location List (Trouble) :Trouble loclist toggle
<leader>xQ n Quickfix List (Trouble) :Trouble qflist toggle
[q n Previous Trouble/Quickfix item -
]q n Next Trouble/Quickfix item -

TODO Comments

Key Mode Description Command
<leader>xt n TODO (Trouble) :Trouble todo toggle
<leader>xT n TODO/Fix/Fixme (Trouble) :Trouble todo toggle filter={tag={TODO,FIX,FIXME}}
<leader>st n Search TODOs (Snacks picker) :lua Snacks.picker.todo_comments()
<leader>sT n Search TODO/Fix/Fixme :lua Snacks.picker.todo_comments({keywords={"TODO","FIX","FIXME"}})
]t n Next TODO comment -
[t n Previous TODO comment -

Neo-tree (File Explorer)

Main Commands

Key Mode Description Command
<leader>fe n Explorer NeoTree (Root Dir) :Neotree
<leader>fE n Explorer NeoTree (cwd) -
<leader>e n Explorer NeoTree (Root Dir) :Neotree
<leader>E n Explorer NeoTree (cwd) -
<leader>ge n Git Explorer :Neotree git_status
<leader>be n Buffer Explorer :Neotree buffers
:E command Open Neotree (NetRW replacement) :Neotree

Window Mappings (when Neo-tree is open)

Key Description
% Add new file
d Add directory
D Delete file/directory
R Rename file/directory
r Refresh
a Disabled (does nothing)

Note: Neo-tree follows the current file and shows filtered items (including hidden files).

DAP (Debugging)

Main Debugging Controls

Key Mode Description Command
<S-CR> n Continue/Start debugging (custom - Shift+Enter) :lua require('dap').continue()
<leader>db n Toggle Breakpoint :DapToggleBreakpoint
<leader>dB n Breakpoint Condition -
<leader>dc n Disabled (use <S-CR>) -
<leader>dC n Run to Cursor :lua require('dap').run_to_cursor()
<leader>da n Run with Args -

Stepping

Key Mode Description Command
<leader>di n Step Into :DapStepInto
<leader>do n Step Out :DapStepOut
<leader>dO n Step Over :DapStepOver
<leader>dg n Go to Line (No Execute) :lua require('dap').goto_()
<leader>dj n Down :lua require('dap').down()
<leader>dk n Up :lua require('dap').up()

Session Management

Key Mode Description Command
<leader>dr n Toggle REPL :lua require('dap').repl.toggle()
<leader>ds n Session :lua require('dap').session()
<leader>dt n Terminate :DapTerminate
<leader>dP n Pause :lua require('dap').pause()
<leader>dl n Run Last :lua require('dap').run_last()

UI & Information

Key Mode Description Command
<leader>du n Toggle DAP UI :lua require('dapui').toggle()
<leader>de n, v Eval :lua require('dapui').eval()
<leader>dw n Widgets :lua require('dap.ui.widgets').hover()

Neotest (Testing)

Note: All test keybindings use capital T (<leader>T*) instead of lowercase.

Key Mode Description Command
<leader>TT n Run File :lua require('neotest').run.run(vim.fn.expand('%'))
<leader>Ta n Attach to Test :lua require('neotest').run.attach()
<leader>Tr n Run Nearest :lua require('neotest').run.run()
<leader>Tl n Run Last :lua require('neotest').run.run_last()
<leader>Ts n Toggle Summary :lua require('neotest').summary.toggle()
<leader>To n Show Output :lua require('neotest').output.open({enter=true, auto_close=true})
<leader>TO n Toggle Output Panel :lua require('neotest').output_panel.toggle()
<leader>TS n Stop :lua require('neotest').run.stop()
<leader>Tw n Toggle Watch :lua require('neotest').watch.toggle(vim.fn.expand('%'))
<leader>Td n Debug Nearest :lua require('neotest').run.run({strategy='dap', suite=false})

Disabled: All lowercase <leader>t* test bindings are disabled to avoid conflicts with Telescope/TODO/Trouble.

Mini Plugins

Mini.surround

See Surround Operations section above.

Mini.move

See Visual Selection Movement section above.

Mason (LSP Installer)

Key Mode Description Command
<leader>ma n Toggle Mason menu (custom) :Mason
<leader>cm n Mason (LazyVim default) :Mason

Tabs

Key Mode Description Command
<leader><tab><tab> n New tab :tabnew
<leader><tab>l n Go to last tab :tablast
<leader><tab>f n Go to first tab :tabfirst
<leader><tab>] n Next tab :tabnext
<leader><tab>[ n Previous tab :tabprevious
<leader><tab>d n Close tab :tabclose
<leader><tab>o n Close other tabs :tabonly

Quickfix & Location List

Key Mode Description Command
<leader>xq n Quickfix list -
<leader>xl n Location list -
<leader>xL n Location List (Trouble) :Trouble loclist toggle
<leader>xQ n Quickfix List (Trouble) :Trouble qflist toggle
[q n Previous Trouble/Quickfix item -
]q n Next Trouble/Quickfix item -

LazyVim UI

Key Mode Description Command
<leader>l n Open Lazy plugin manager :Lazy
<leader>L n Show LazyVim changelog -
<leader>qq n Quit all :qa
<leader>ui n Inspect highlight at cursor :Inspect
<leader>uI n Inspect treesitter tree :InspectTree
<leader>? n Buffer keymaps help -

Noice (Command Line & Notifications)

Key Mode Description
<C-f> n, i, s Scroll Forward
<C-b> n, i, s Scroll Backward
<S-Enter> c Redirect Cmdline
<leader>sn n +noice
<leader>sna n Noice All
<leader>snd n Dismiss All
<leader>snh n Noice History
<leader>snl n Noice Last Message
<leader>snt n Noice Picker

Session Management (Persistence)

Key Mode Description
<leader>qs n Restore Session
<leader>qS n Select Session
<leader>ql n Restore Last Session
<leader>qd n Don't Save Current Session

Which-Key Groups

These are prefix groups for organizing keymaps:

Prefix Group Name
<leader><tab> Tabs
<leader>a AI (Claude Code)
<leader>b Buffer
<leader>c Code
<leader>C Code Actions (capital C - custom LSP)
<leader>d Debug (DAP)
<leader>dp Profiler
<leader>f File/Find
<leader>g Git
<leader>gh Git Hunks
<leader>q Quit/Session
<leader>s Search
<leader>sn Noice
<leader>t Test (Neotest - LazyVim default)
<leader>T Test (Neotest - custom capital T bindings)
<leader>u UI Toggles
<leader>w Windows
<leader>x Diagnostics/Quickfix
g Goto
gs Surround
z Fold
[ Prev
] Next

Configuration Notes

  • Leader Key: Space (<Space>)
  • Local Leader Key: Backslash (\)
  • Default Picker: Snacks (configured via vim.g.lazyvim_picker = "snacks")
  • Tab Width: 4 spaces (auto-detected per file)
  • Line Numbers: Relative line numbers enabled
  • Scrolloff: 10 lines
  • Colorscheme: rose-pine
  • Terminal: Uses ToggleTerm with floating direction
  • NetRW: Disabled (using Neo-tree instead)

LSP Servers Configured

  • bashls (Bash)
  • bufls (Protocol Buffers)
  • cssls (CSS)
  • dotls (Graphviz DOT)
  • lua_ls (Lua)
  • sourcekit (Swift)
  • vimls (VimScript)
  • Plus all language servers from enabled LazyVim language extras

Installed Language Support

Based on installed plugins (not via LazyVim Extras):

  • Clangd, CMake, Dart, Go, Helm, Markdown, Python, Rust, Tailwind, Terraform, TeX, Zig

Note: LazyVim Extras (lazyvim.json) is empty. Language support comes from manually installed plugins.

Disabled Features

  • Snacks.nvim explorer (using Neo-tree instead)
  • <leader>dc for DAP continue (using <S-CR> instead)
  • All lowercase <leader>t* neotest bindings (using <leader>T* instead)

Keybind Notes

  • <C-space> - blink.cmp (insert mode) and Flash (normal/visual mode) coexist in different modes
  • <C-t> - toggleterm overrides Vim tag stack (acceptable if not using ctags)

Resources

Last Updated: 2025-12-29