Keybindings & Shortcuts

GentlemanNvim extends LazyVim’s default keybindings with custom mappings optimized for frontend development and AI-assisted workflows.

Leader key is Space. All keybindings shown with <leader> use the spacebar as the prefix.

Quick Reference

AI Assistants

<leader>a prefix for all AI tools

File Navigation

- for Oil, <C-hjkl> for tmux

Obsidian Notes

<leader>o prefix for note-taking

Git Operations

<leader>g for git blame/browse

Essential Keybindings

Saving & Exiting

Keymap	Mode	Action	Notes
`<C-s>`	n	Save file	Custom save function with notification
`<C-c>`	i, n, v	Escape to normal	Universal escape

-- Custom save function
function SaveFile()
  if vim.fn.empty(vim.fn.expand("%:t")) == 1 then
    vim.notify("No file to save", vim.log.levels.WARN)
    return
  end
  
  local filename = vim.fn.expand("%:t")
  local success, err = pcall(function()
    vim.cmd("silent! write")
  end)
  
  if success then
    vim.notify(filename .. " Saved!")
  else
    vim.notify("Error: " .. err, vim.log.levels.ERROR)
  end
end

AI Assistant Keybindings

OpenCode (Active)

Primary AI Keybindings

Keymap	Mode	Action
`<leader>aa`	n	Toggle OpenCode panel
`<leader>as`	n, x	Select code and submit
`<leader>ai`	n, x	Ask with empty prompt
`<leader>aI`	n, x	Ask with `@this:` context
`<leader>ab`	n, x	Ask about current buffer
`<leader>ap`	n, x	Custom prompt with `@this`

Built-in AI Prompts

Keymap	Mode	Action	Prompt
`<leader>ape`	n, x	Explain code	Explain selected code
`<leader>apf`	n, x	Fix code	Fix issues
`<leader>apd`	n, x	Diagnose	Diagnose problems
`<leader>apr`	n, x	Review	Code review
`<leader>apt`	n, x	Tests	Generate tests
`<leader>apo`	n, x	Optimize	Optimize performance

Visual mode selection automatically includes context. Use <leader>ai for custom questions about selected code.

CodeCompanion (When Enabled)

CodeCompanion Keybindings

Keymap	Mode	Action
`<leader>ac`	n, v	Toggle chat window
`<leader>an`	n, v	New chat session
`<leader>aa`	n, v	CodeCompanion actions menu
`ga`	v	Add selection to chat
`<leader>ae`	v	Explain selection

In Chat Window:

<CR> (normal) - Send message
<C-s> (insert) - Send message
<C-c> - Close chat
ga (normal) - Accept inline change
gr (normal) - Reject inline change

Oil.nvim - File Manager

Keymap	Mode	Action
`-`	n	Open parent directory
`<leader>E`	n	Open Oil in floating window
`<leader>-`	n	Open Oil in current file’s directory

Within Oil Buffer:

keymaps = {
  ["<CR>"] = "actions.select",
  ["<C-s>"] = "vertical split",
  ["<C-v>"] = "horizontal split",
  ["<C-t>"] = "new tab",
  ["<C-p>"] = "actions.preview",
  ["<C-c>"] = "actions.close",
  ["<C-r>"] = "actions.refresh",
  ["-"] = "actions.parent",
  ["_"] = "actions.open_cwd",
  ["g."] = "actions.toggle_hidden",
  ["q"] = "actions.close",
}

Oil edits your filesystem like a buffer. Make changes and save with :w - deletions are permanent!

Goto Preview

Keymap	Mode	Action
`gpd`	n	Preview definition
`gpD`	n	Preview declaration
`gpi`	n	Preview implementation
`gpy`	n	Preview type definition
`gpr`	n	Preview references
`gP`	n	Close all preview windows

Tmux Integration

local nvim_tmux_nav = require("nvim-tmux-navigation")

vim.keymap.set("n", "<C-h>", nvim_tmux_nav.NvimTmuxNavigateLeft)
vim.keymap.set("n", "<C-j>", nvim_tmux_nav.NvimTmuxNavigateDown)
vim.keymap.set("n", "<C-k>", nvim_tmux_nav.NvimTmuxNavigateUp)
vim.keymap.set("n", "<C-l>", nvim_tmux_nav.NvimTmuxNavigateRight)
vim.keymap.set("n", "<C-\\", nvim_tmux_nav.NvimTmuxNavigateLastActive)
vim.keymap.set("n", "<C-Space>", nvim_tmux_nav.NvimTmuxNavigateNext)

Keymap	Action
`<C-h>`	Navigate left (Neovim split or tmux pane)
`<C-j>`	Navigate down
`<C-k>`	Navigate up
`<C-l>`	Navigate right
`<C-\>`	Navigate to last active pane
`<C-Space>`	Navigate to next pane

These keybindings work identically in both Neovim and tmux, providing a seamless navigation experience.

Obsidian Note-Taking

Global Obsidian Commands

Keymap	Mode	Action
`<leader>oc`	n	Check/toggle checkbox
`<leader>ot`	n	Insert template
`<leader>oo`	n	Open note in Obsidian app
`<leader>ob`	n	Show backlinks
`<leader>ol`	n	Show outgoing links
`<leader>on`	n	Create new note
`<leader>os`	n	Search notes
`<leader>oq`	n	Quick switch between notes

Within Obsidian Notes

callbacks = {
  enter_note = function(client, note)
    -- Active when in Obsidian buffer
    vim.keymap.set("n", "gf", function()
      return require("obsidian").util.gf_passthrough()
    end, { buffer = note.bufnr })
    
    vim.keymap.set("n", "<leader>ch", function()
      return require("obsidian").util.toggle_checkbox()
    end, { buffer = note.bufnr })
    
    vim.keymap.set("n", "<cr>", function()
      return require("obsidian").util.smart_action()
    end, { buffer = note.bufnr })
  end,
}

Keymap	Mode	Action
`gf`	n	Follow link under cursor
`<leader>ch`	n	Toggle checkbox
`<CR>`	n	Smart action (follow link/toggle checkbox)

Search & Grep

Visual Selection Search

Advanced Search Keybindings

Search Selected Text in Current Directory:

vim.keymap.set("v", "<leader>sg", function()
  -- Greps selected text in current working directory
  local selected_text = get_visual_selection()
  require("snacks").picker.grep({ search = selected_text })
end)

Search Selected Text in Git Root:

vim.keymap.set("v", "<leader>sG", function()
  -- Greps selected text from git root
  local git_root = vim.fn.system("git rev-parse --show-toplevel")
  local selected_text = get_visual_selection()
  require("snacks").picker.grep({ search = selected_text, cwd = root })
end)

Keymap	Mode	Action
`<leader>sg`	v	Grep selected text (CWD)
`<leader>sG`	v	Grep selected text (Git root)

Buffer Management

Keymap	Mode	Action
`<leader>bq`	n	Delete all buffers except current

vim.keymap.set(
  "n",
  "<leader>bq",
  '<Esc>:%bdelete|edit #|normal`"<Return>',
  { desc = "Delete other buffers but the current one" }
)

Editing Enhancements

Insert Mode Shortcuts

Keymap	Mode	Action
`<C-b>`	i	Delete to end of word (like `de`)

-- Delete to end of word without leaving insert mode
vim.keymap.set("i", "<C-b>", "<C-o>de")

Disabled Default Keybindings

The following LazyVim defaults are disabled to prevent conflicts:

These keybindings are explicitly disabled:

<A-j> / <A-k> - Move lines up/down (insert, normal, visual)
J / K - Move visual selection (visual mode)

-- Disable line movement keybindings
vim.api.nvim_set_keymap("i", "<A-j>", "<Nop>", { noremap = true })
vim.api.nvim_set_keymap("i", "<A-k>", "<Nop>", { noremap = true })
vim.api.nvim_set_keymap("n", "<A-j>", "<Nop>", { noremap = true })
vim.api.nvim_set_keymap("n", "<A-k>", "<Nop>", { noremap = true })
vim.api.nvim_set_keymap("x", "J", "<Nop>", { noremap = true })
vim.api.nvim_set_keymap("x", "K", "<Nop>", { noremap = true })

Git Integration

Keymap	Mode	Action
`<leader>gb`	n	Open Git blame window
`<leader>go`	n	Browse file in GitHub/GitLab

Utility Keybindings

Marks

Keymap	Mode	Action
`<leader>md`	n	Delete all marks

vim.keymap.set("n", "<leader>md", function()
  vim.cmd("delmarks!")
  vim.cmd("delmarks A-Z0-9")
  vim.notify("All marks deleted")
end)

Screen Recording

Keymap	Mode	Action
`<leader>uk`	n	Toggle Screenkey (show keypresses)

Zen Mode

Keymap	Mode	Action
`<leader>z`	n	Toggle Zen Mode (distraction-free)

LazyVim Default Keybindings

GentlemanNvim inherits all LazyVim default keybindings. Key highlights:

LazyVim Defaults (Selection)

File Navigation:

<leader>ff - Find files
<leader>fg - Live grep
<leader>fb - Browse buffers
<leader>fr - Recent files

LSP:

gd - Go to definition
gr - Go to references
K - Hover documentation
<leader>ca - Code actions
<leader>rn - Rename symbol

Diagnostics:

]d - Next diagnostic
[d - Previous diagnostic
<leader>cd - Line diagnostics

Windows:

<C-w>s - Split horizontal
<C-w>v - Split vertical
<C-w>q - Close window

Full documentation: LazyVim Keymaps

Which-Key Integration

Press <leader>? to show context-aware keybindings:

vim.keymap.set("<leader>?", function()
  require("which-key").show({ global = false })
end)

Start typing a keymap sequence and pause - which-key will show available completions after 300ms.

Custom Functions

Some keybindings trigger custom Lua functions:

SaveFile()

Enhanced save with notifications:

function SaveFile()
  -- Check if buffer has a file
  if vim.fn.empty(vim.fn.expand("%:t")) == 1 then
    vim.notify("No file to save", vim.log.levels.WARN)
    return
  end

  local filename = vim.fn.expand("%:t")
  local success, err = pcall(function()
    vim.cmd("silent! write")
  end)

  if success then
    vim.notify(filename .. " Saved!")
  else
    vim.notify("Error: " .. err, vim.log.levels.ERROR)
  end
end

Visual Selection Grep

Intelligent text search with automatic escaping:

View Implementation

vim.keymap.set("v", "<leader>sg", function()
  local start_pos = vim.fn.getpos("'<")
  local end_pos = vim.fn.getpos("'>")
  local lines = vim.fn.getline(start_pos[2], end_pos[2])
  
  if #lines == 0 then return end
  
  -- Handle single/multi-line selection
  if #lines == 1 then
    lines[1] = string.sub(lines[1], start_pos[3], end_pos[3])
  else
    lines[1] = string.sub(lines[1], start_pos[3])
    lines[#lines] = string.sub(lines[#lines], 1, end_pos[3])
  end
  
  local selected_text = table.concat(lines, "\n")
  selected_text = vim.fn.escape(selected_text, "\\.\*[]^$()+?{}")
  
  require("snacks").picker.grep({ search = selected_text })
end)

Cheat Sheet

AI Assistant

<leader>aa - Toggle AI
<leader>ai - Ask AI
<leader>ape - Explain
<leader>apf - Fix

Files

- - Oil (parent)
<leader>E - Oil (float)
<leader>ff - Find file
<leader>fg - Grep

Navigation

<C-hjkl> - Tmux/splits
gd - Definition
gpd - Preview def
gP - Close previews

Notes

<leader>on - New note
<leader>os - Search
<leader>oq - Quick switch
gf - Follow link

Get Started

Terminal Emulators

Shells

Window Managers

Neovim Configuration

AI Integration

Platform-Specific Guides

Advanced

​Keybindings & Shortcuts

​Quick Reference

AI Assistants

File Navigation

Obsidian Notes

Git Operations

​Essential Keybindings

​Saving & Exiting

​AI Assistant Keybindings

​OpenCode (Active)

​Built-in AI Prompts

​CodeCompanion (When Enabled)

​File Navigation

​Oil.nvim - File Manager

​Goto Preview

​Tmux Integration

​Seamless Pane Navigation

​Obsidian Note-Taking

​Global Obsidian Commands

​Within Obsidian Notes

​Search & Grep

​Visual Selection Search

​Buffer Management

​Editing Enhancements

​Insert Mode Shortcuts

​Disabled Default Keybindings

​Git Integration

​Utility Keybindings

​Marks

​Screen Recording

​Zen Mode

​LazyVim Default Keybindings

​Which-Key Integration

​Custom Functions

​SaveFile()

​Visual Selection Grep

​Cheat Sheet

AI Assistant

Files

Navigation

Notes

Build docs developers (and LLMs) love

Keybindings & Shortcuts

Quick Reference

Essential Keybindings

Saving & Exiting

AI Assistant Keybindings

OpenCode (Active)

Built-in AI Prompts

CodeCompanion (When Enabled)

File Navigation

Oil.nvim - File Manager

Goto Preview

Tmux Integration

Seamless Pane Navigation

Obsidian Note-Taking

Global Obsidian Commands

Within Obsidian Notes

Search & Grep

Visual Selection Search

Buffer Management

Editing Enhancements

Insert Mode Shortcuts

Disabled Default Keybindings

Git Integration

Utility Keybindings

Marks

Screen Recording

Zen Mode

LazyVim Default Keybindings

Which-Key Integration

Custom Functions

SaveFile()

Visual Selection Grep

Cheat Sheet