Keymaps

Keymaps

Leader key is ;. In normal mode ; is also mapped to : (enter command mode), so leader sequences must be typed within timeoutlen. Pause after ; for ~300 ms and which-key shows available bindings grouped by prefix.

which-key Groups

Prefix	Group
<leader>ai	AI
<leader>b	buffer
<leader>c	code
<leader>d	debug
<leader>e	explorer
<leader>f	find / format
<leader>g	git
<leader>h	git hunks
<leader>n	notifications
<leader>s	search
<leader>t	test
<leader>x	diagnostics (Trouble)

General

Key	Action
;	Enter command mode (:)
<CR>	Clear search highlight
n / N	Next / prev match (direction-aware)
j / k	Move by visual line (gj / gk)
;;	Select current line (V)
Q	Disabled (prevents accidental Ex mode)

Splits & Tabs

Key	Action
<C-h/j/k/l>	Move between splits
<S-h>	Previous tab
<S-l>	Next tab

Visual Mode

Key	Action
<	Indent left, keep selection
>	Indent right, keep selection

Config Shortcuts

Key	Action
<leader>vr	Reload config (:source $MYVIMRC)
<leader>ve	Edit config (:edit $MYVIMRC)

Navigation

Key	Action
s	Flash jump (any visible char, normal/visual/op)
S	Flash treesitter jump
-	Open parent directory (Oil)
<leader>e	Toggle nvim-tree sidebar
<leader>a	Toggle Aerial (code outline)

Search & Pickers (Snacks)

Key	Action
<leader><space>	Smart find files
<leader>,	Buffer list
<leader>/	Live grep
<leader>:	Command history
<leader>n	Notification history
<leader>un	Dismiss all notifications
<leader>bd	Delete buffer (keeps layout)

Search (Telescope)

Key	Action
<C-p>	Find files
<leader>ff	Grep → quickfix (ripgrep)
<leader>fF	Live grep
<leader>fb	Open buffers
<leader>fh	Help tags

Git

Key	Action
<leader>gd	Diffview open
<leader>gD	Diffview close
<leader>gh	File history (Diffview)
<leader>gB	Git browse (open in GitHub)
]h / [h	Next / prev hunk (Gitsigns)
<leader>hs	Stage hunk
<leader>hr	Reset hunk
<leader>hp	Preview hunk

LSP (buffer-local, set on LspAttach)

Key	Action
gd	Go to definition
K	Hover documentation
gr	References
<leader>rn	Rename symbol
<leader>ca	Code action
[d / ]d	Previous / next diagnostic
<leader>d	Diagnostic float
<leader>q	Diagnostics → location list
<leader>ih	Toggle inlay hints (ruby_lsp only)

Formatting & Diagnostics

Key	Action
<leader>f	Format buffer (conform.nvim, any mode)
<leader>xx	Trouble diagnostics toggle
<leader>xX	Trouble buffer diagnostics
<leader>cs	Trouble symbols
<leader>cl	Trouble LSP definitions/references
<leader>xL	Trouble location list
<leader>xQ	Trouble quickfix

Testing (Neotest)

Key	Action
<leader>tr	Run nearest test
<leader>tf	Run all tests in file
<leader>tl	Re-run last test
<leader>ts	Toggle test summary sidebar
<leader>to	Show test output (float)
<leader>tO	Toggle persistent output panel
<leader>tS	Stop test run

Debugging (DAP)

Key	Action
<leader>db	Toggle breakpoint
<leader>dc	Continue
<leader>di	Step into
<leader>do	Step over
<leader>du	Toggle DAP UI
<leader>dr	Open REPL
<leader>dt	Terminate session

AI (CodeCompanion)

Key	Action
<leader>aia	CodeCompanion action menu
<leader>aic	CodeCompanion chat

zdots Platform Integration

Key / Command	Action
<leader>zi	Ingest current buffer into zdots context engine
<leader>zt	Open interactive task picker (ztask)
:ZdotsIngest	Same as <leader>zi
:ZdotsStatus	zdots platform status in a floating window

Todo Comments

Key	Action
]t	Next todo comment
[t	Previous todo comment
<leader>st	Search todos (Telescope)

Treesitter Text Objects

Key	Object
af / if	Function outer / inner
ac / ic	Class outer / inner
ab / ib	Block outer / inner
]m / [m	Jump to next / prev function start
]M / [M	Jump to next / prev function end

Commands

Command	Action
:PackSync	Update all plugins (vim.pack.update())
:Reload	Re-source $MYVIMRC
:Vimrc / :Svimrc / :Tvimrc / :Vvimrc	Edit / split / tab / vsplit vimrc
:Zshenv / :Szshenv / :Tzshenv / :Vzshenv	Edit / split / tab / vsplit .zshenv
:ZdotsIngest	Ingest current buffer into zdots
:ZdotsStatus	Platform status float
:ConformInfo	Show conform.nvim formatter info