Keymaps

This configuration uses a carefully organized system of keymaps with <Space> as the leader key. Keymaps are defined in multiple locations based on their scope and purpose.

Keymap organization

Keymaps in this configuration are organized into three categories:

Global keymaps - Defined in lua/config/keymaps.lua for universal operations
LSP keymaps - Buffer-local keymaps set in lua/plugins/lsp/init.lua when LSP attaches
Plugin keymaps - Defined within individual plugin configuration files

Leader key configuration

The leader key is set to <Space> at the very beginning of initialization:

init.lua:2-3

vim.g.mapleader = " "
vim.g.maplocalleader = " "

The leader key must be set before lazy.nvim loads to ensure all plugin keymaps use the correct leader.

Global keymaps

Editing operations

Key	Mode	Description
`J`	visual	Move selected lines down
`K`	visual	Move selected lines up
`<`	visual	Indent left (stays in visual mode)
`>`	visual	Indent right (stays in visual mode)
`X`	normal	Split line at cursor position
`d`	normal, visual	Delete without copying to clipboard
`D`	normal, visual	Delete to end of line without copying

Key	Mode	Description
`H`	normal, visual, operator	Jump to start of line (^)
`L`	normal, visual, operator	Jump to end of line (g_)
`<Left>`	normal	Previous buffer
`<Right>`	normal	Next buffer

All search operations keep results centered for better visibility:

Key	Mode	Description
`n`	normal	Next match (centered)
`N`	normal	Previous match (centered)
`*`	normal	Search word under cursor (centered)
`#`	normal	Search word backward (centered)
`g*`	normal	Search partial word (centered)
`g#`	normal	Search partial word backward (centered)

lua/config/keymaps.lua:25-31

vim.keymap.set("n", "n", "nzzzv", { desc = "Next Match (centered)" })
vim.keymap.set("n", "N", "Nzzzv", { desc = "Prev Match (centered)" })
vim.keymap.set("n", "*", "*zzzv", { desc = "Search Word (centered)" })
vim.keymap.set("n", "#", "#zzzv", { desc = "Search Word Back (centered)" })
vim.keymap.set("n", "g*", "g*zz", { desc = "Search Partial (centered)" })
vim.keymap.set("n", "g#", "g#zz", { desc = "Search Partial Back (centered)" })

Lua execution

Execute Lua code directly in Neovim:

Key	Mode	Description
`<leader>rc`	normal	Source current file
`<leader>x`	normal	Execute current line as Lua
`<leader>x`	visual	Execute selection as Lua

Quickfix and diagnostics

Key	Mode	Description
`<M-j>`	normal	Next quickfix item
`<M-k>`	normal	Previous quickfix item
`<M-q>`	normal	Open quickfix list
`<leader>q`	normal	Open diagnostic quickfix list
`<leader>de`	normal	Show diagnostic error messages in float

Utility keymaps

Line numbers in visual mode

Get highlighted line numbers when selecting code:

lua/config/keymaps.lua:33-39

vim.keymap.set(
  "v",
  "<leader>ln",
  ':lua require("core.utils").get_highlighted_line_numbers()<CR>',
  { desc = "Copy Line Numbers", silent = true }
)

File path copying

Copy the current file path with line number:

lua/config/keymaps.lua:136-138

vim.keymap.set("n", "<leader>cp", function()
  require("core.utils").copyFilePathAndLineNumber()
end, { desc = "Copy file path with line number" })

Link opening

Open URLs or file paths under cursor:

lua/config/keymaps.lua:64-71

vim.keymap.set("n", "gX", function()
  local target = vim.fn.expand("<cfile>")
  if target == nil or target == "" then
    vim.notify("No link under cursor", vim.log.levels.WARN)
    return
  end
  vim.ui.open(target)
end, { desc = "Open link under cursor" })

Terminal mode

Key	Mode	Description
`<Esc><Esc>`	terminal	Exit terminal mode to normal mode

Window management

Floating window focus

Jump into floating windows (diagnostic floats, hover windows, etc.):

lua/config/keymaps.lua:91-100

vim.keymap.set("n", "<C-w>f", function()
  local wins = vim.api.nvim_list_wins()
  for _, win in ipairs(wins) do
    local config = vim.api.nvim_win_get_config(win)
    if config.relative ~= "" then -- This is a floating window
      vim.api.nvim_set_current_win(win)
      break
    end
  end
end, { desc = "Focus floating [W]indow" })

Code actions

Tiny code action

Enhanced code action UI:

lua/config/keymaps.lua:114-116

vim.keymap.set({ "n", "x" }, "<leader>ca", function()
  require("tiny-code-action").code_action({})
end, { noremap = true, silent = true, desc = "[C]ode [A]ction" })

Code lens

Run available code lens actions:

lua/config/keymaps.lua:119

vim.keymap.set("n", "<leader>cl", vim.lsp.codelens.run, { desc = "Run [C]ode[L]ens actions" })

Call hierarchy

LSP call hierarchy navigation:

lua/config/keymaps.lua:122-134

-- Show incoming calls (who calls this function)
vim.keymap.set(
  "n",
  "<leader>ci",
  vim.lsp.buf.incoming_calls,
  { desc = "Show [C]all hierarchy [I]ncoming" }
)

-- Show outgoing calls (what this function calls)
vim.keymap.set(
  "n",
  "<leader>co",
  vim.lsp.buf.outgoing_calls,
  { desc = "Show [C]all hierarchy [O]utgoing" }
)

Diagnostic yank

Copy diagnostic message under cursor to clipboard:

lua/config/keymaps.lua:74-88

vim.keymap.set("n", "<leader>dy", function()
  local diagnostics = vim.diagnostic.get(0, { lnum = vim.fn.line(".") - 1 })
  if #diagnostics > 0 then
    local messages = {}
    for _, diag in ipairs(diagnostics) do
      table.insert(messages, diag.message)
    end
    local full_message = table.concat(messages, "\n")
    vim.fn.setreg("+", full_message)
    vim.fn.setreg('"', full_message)
    vim.notify("Diagnostic message(s) yanked to clipboard", vim.log.levels.INFO)
  else
    vim.notify("No diagnostic message on this line", vim.log.levels.WARN)
  end
end, { desc = "[D]iagnostic [Y]ank message" })

Disabled keymaps

Command-line window (q:)

The command-line window is disabled to prevent accidental activation:

lua/config/keymaps.lua:141-143

vim.keymap.set({ "n", "v" }, "q:", function()
  vim.notify("Command-line window (q:) is disabled. Use :q to quit.", vim.log.levels.INFO)
end, { desc = "Disable command-line window (q:)" })

Customization

For complete keymap references organized by feature, see:

General keymaps

Editing, navigation, and utility keymaps

LSP keymaps

Language server protocol keybindings

Git keymaps

Git operations and version control

Navigation keymaps

File and buffer navigation

Adding custom keymaps

To add your own keymaps, edit lua/config/keymaps.lua:

lua/config/keymaps.lua

-- Add at the end of the file
vim.keymap.set("n", "<leader>my", function()
  -- Your custom function
end, { desc = "My custom keymap" })

Always provide a descriptive desc field for keymaps. This makes them discoverable in which-key (<leader>?) and helps with documentation.

For plugin-specific keymaps, define them in the plugin’s configuration file in lua/plugins/. For LSP keymaps, modify the setup_keymaps() function in lua/plugins/lsp/init.lua.

Get Started

Core Configuration

Language Support

Plugin Guide

Customization

Keymap organization

Leader key configuration

Global keymaps

Editing operations

Navigation shortcuts

Centered search navigation

Lua execution

Quickfix and diagnostics

Utility keymaps

Line numbers in visual mode

File path copying

Link opening

Terminal mode

Window management

Floating window focus

Code actions

Tiny code action

Code lens

Call hierarchy

Diagnostic yank

Disabled keymaps

Command-line window (q:)

Customization

General keymaps

LSP keymaps

Git keymaps

Navigation keymaps

Adding custom keymaps

Build docs developers (and LLMs) love

Get Started

Core Configuration

Language Support

Plugin Guide

Customization

​Keymap organization

​Leader key configuration

​Global keymaps

​Editing operations

​Navigation shortcuts

​Centered search navigation

​Lua execution

​Quickfix and diagnostics

​Utility keymaps

​Line numbers in visual mode

​File path copying

​Link opening

​Terminal mode

​Window management

​Floating window focus

​Code actions

​Tiny code action

​Code lens

​Call hierarchy

​Diagnostic yank

​Disabled keymaps

​Command-line window (q:)

​Customization

General keymaps

LSP keymaps

Git keymaps

Navigation keymaps

​Adding custom keymaps

Build docs developers (and LLMs) love

Keymap organization

Leader key configuration

Global keymaps

Editing operations

Navigation shortcuts

Centered search navigation

Lua execution

Quickfix and diagnostics

Utility keymaps

Line numbers in visual mode

File path copying

Link opening

Terminal mode

Window management

Floating window focus

Code actions

Tiny code action

Code lens

Call hierarchy

Diagnostic yank

Disabled keymaps

Command-line window (q:)

Customization

Adding custom keymaps