Files

Carlos Gutierrez 2bf56c05dc doc: Update documentation

- Moved docs to docs/ - All documentation files moved:
  - docs/KEYMAPS.md - Complete keybinding reference(rewritten)
  - docs/PLUGINS.md - Plugin list
  - docs/NATIVE_AUTO_WRAPPER_GUIDE.md - Text wrapping guide
  - docs/TELESCOPE_TO_SNACKS_MIGRATION.md - Migration notes
  - docs/keyboard_mappings.md - QMK keyboard layout
  - docs/CHANGELOG_OLD.md - Previous changelog archived
- Rewrote docs/KEYMAPS.md - Based on the actual current keymap files. Removed references to deleted plugins (flash, harpoon, dial, screenkey, persistence, LSPSaga). Updated LSP keymaps to reflect fzf-lua, DAP keymaps to reflect plugin-side registration, and added CopilotChat and g keymaps.
- Updated README.md - Fixed all doc links to docs/, removed harpoon/flash/dial/screenkey/persistence references, updated essential keymaps to current reality (fzf-lua for LSP, Snacks for navigation, <leader>dcr for debug, <leader>jd for dynamic attach), added Bun debug support mention.
- Created CHANGELOG.md at root with:
  - 2026-02-10: Documentation restructure
  - 2026-02-08: hlchunk, lspconfig, lualine, ufo fixes
  - 2026-02-05: Major cleanup - 15+ plugins removed, core refactors, keymap rework, DAP/Copilot reorganization, fzf-lua migration for LSP
  - 2026-01-13/15: Bug fixes and version bumps
  - 2026-01-10: Previous changelog entries preserved

2026-02-10 12:49:09 -05:00

14 KiB

Raw Permalink Blame History

Complete Keymaps Reference

Leader Key: <Space>

General
Personal Workflow
Navigation (Snacks Picker)
LSP & Code Intelligence
File Management
Editing
Git
Debugging (DAP)
Copilot & AI
Terminal
Window Management
Database
LeetCode
Text Wrapping
Folding (nvim-ufo)
Session Management
Commands

General

Key	Mode	Action
`jj`	i	Exit insert mode
`<leader>nh`	n	Clear search highlights
`<leader>Q`	n	Quit all

Personal Workflow

File Management

Key	Mode	Action
`<leader>w`	n	Save file
`<leader>q`	n	Quit
`<leader>xa`	n	Save and close all
`<leader>so`	n	Reload nvim (source %)
`<leader>no`	n	Clear search highlight

Editing Shortcuts

Key	Mode	Action
`<leader>u`	n	Select entire file
`<leader>4`	n	Duplicate line below
`<leader>+`	n	Increment number
`<leader>-`	n	Decrement number
`<leader>sy`	n	Re-indent entire file
`<C-e>`	n	Fast scroll down (10 lines)
`<C-y>`	n	Fast scroll up (10 lines)

Buffer Management

Key	Mode	Action
`<leader>bd`	n	Close buffer (safe, prompts if modified)
`<leader>bD`	n	Force close buffer
`<C-p>`	n	Next buffer
`<C-n>`	n	Previous buffer

Coding Shortcuts

Key	Mode	Action
`<leader>re`	n	Insert React import at top
`<leader>,`	n	Add comma at end of line
`<leader>;`	n	Add semicolon at end of line
`<leader>xr`	n	Run file with Node.js

Key	Mode	Action
`<leader>xn`	n	Next quickfix item
`<leader>xp`	n	Previous quickfix item
`<leader>xo`	n	Open quickfix list
`<leader>xq`	n	Close quickfix list
`<leader>xf`	n	First quickfix item
`<leader>xl`	n	Last quickfix item

Key	Mode	Action
`<leader>ln`	n	Next location item
`<leader>lp`	n	Previous location item
`<leader>lo`	n	Open location list
`<leader>lq`	n	Close location list

Key	Mode	Action
`<leader>ff`	n	Find files
`<leader>fs`	n	Live grep
`<leader>fc`	n	Grep string under cursor
`<leader>fr`	n	Recent files

Buffer & Utility Search

Key	Mode	Action
`<leader>fb`	n	Find buffers
`<leader>fh`	n	Help tags
`<leader>fm`	n	Find marks
`<leader>fk`	n	Find keymaps
`<leader>fC`	n	Find commands

Git (Telescope Fallback)

Key	Mode	Action
`<leader>fG`	n	Git commits
`<leader>fB`	n	Git buffer commits
`<leader>fg`	n	Git branches
`<leader>gs`	n	Git status

TODO Search

Key	Mode	Action
`<leader>ft`	n	Find TODOs (Telescope)

Telescope (Unfiltered)

Key	Mode	Action
`<leader>fF`	n	Find files (all, unfiltered)

LSP & Code Intelligence

Key	Mode	Action
`gd`	n	Go to definition
`gi`	n	Go to implementation
`gr`	n	Show references
`gt`	n	Go to type definition

Symbols

Key	Mode	Action
`<leader>ds`	n	Document symbols
`<leader>lw`	n	Workspace symbols

Code Actions & Rename

Key	Mode	Action
`<leader>ca`	n	Code actions
`<leader>rn`	n	Rename symbol
`H`	n	Hover documentation

Diagnostics

Key	Mode	Action
`<leader>D`	n	Workspace diagnostics
`<leader>dd`	n	Line diagnostics (float)
`[d`	n	Previous diagnostic
`]d`	n	Next diagnostic

Formatting

Key	Mode	Action
`<leader>mm`	n, v	Format with conform

File Management

File Explorer (nvim-tree)

Key	Mode	Action
`<leader>e`	n	Toggle file explorer

Inside nvim-tree:

Key	Action
`o`	Open file
`s`	Open in vertical split
`i`	Open in horizontal split
`a`	Create new file
`r`	Rename
`d`	Delete
`x`	Cut
`y`	Copy
`p`	Paste
`u`	Go up one directory
`<leader>f`	Change root to node

Buffer Cycling

Key	Mode	Action
`<S-l>`	n	Next buffer
`<S-h>`	n	Previous buffer

Editing

Comments (Comment.nvim)

Key	Mode	Action
`<leader>/`	n, v	Toggle comment
`gcc`	n	Toggle line comment
`gc`	n	Toggle comment
`gco`	n	Insert comment below
`gcO`	n	Insert comment above
`gcA`	n	Insert comment at end of line
`gb`	n	Toggle block comment
`gbc`	n	Toggle block comment

Substitute (substitute.nvim)

Key	Mode	Action
`<leader>sub`	n	Substitute with motion
`<leader>sl`	n	Substitute line
`<leader>S`	n	Substitute to end of line

Surround (nvim-surround)

Key	Mode	Action
`<leader>sa`	n	Add surrounding
`<leader>sd`	n	Delete surrounding
`<leader>sr`	n	Replace surrounding
`ys`	n	Add surrounding (classic)
`yss`	n	Add surrounding to line
`yS`	n	Add surrounding on new lines
`ySS`	n	Add surrounding to line on new lines

Console.log

Key	Mode	Action
`<leader>cl`	n	Insert console.log snippet

TODO Comments

Key	Mode	Action
`<leader>xt`	n	Open TODOs in Trouble

Git

LazyGit

Key	Mode	Action
`<leader>gg`	n	Open LazyGit

Gitsigns (buffer-local)

Key	Mode	Action
`]h`	n	Next hunk
`[h`	n	Previous hunk
`<leader>hs`	n, v	Stage hunk
`<leader>hr`	n, v	Reset hunk
`<leader>hS`	n	Stage buffer
`<leader>hR`	n	Reset buffer
`<leader>hu`	n	Undo stage hunk
`<leader>hp`	n	Preview hunk
`<leader>hb`	n	Blame line (full)
`<leader>hB`	n	Toggle line blame
`<leader>hd`	n	Diff this
`<leader>hD`	n	Diff this ~
`ih`	o, x	Select hunk (text object)

Trouble (Diagnostics Panel)

Key	Mode	Action
`<leader>Xx`	n	Toggle Trouble
`<leader>Xw`	n	Workspace diagnostics
`<leader>Xd`	n	Document diagnostics
`<leader>Xl`	n	Location list
`<leader>Xq`	n	Quickfix list

Debugging (DAP)

Debug Control

Key	Mode	Action
`<leader>dcr`	n	Start/Continue debugging
`<leader>do`	n	Step over
`<leader>di`	n	Step into
`<leader>dot`	n	Step out
`<leader>db`	n	Toggle breakpoint
`<leader>dB`	n	Set conditional breakpoint
`<leader>dr`	n	Open REPL
`<leader>dl`	n	Run last debug config
`<leader>du`	n	Toggle DAP UI
`<leader>dq`	n	Stop debugging
`<leader>drt`	n	Reset DAP UI layout

Key	Mode	Action
`<leader>dcf`	n	List/select DAP configs
`<leader>dcb`	n	List breakpoints
`<leader>dco`	n	DAP Commands (REPL)

Dynamic Attach

Key	Mode	Action
`<leader>jd`	n	Debug attach (dynamic port, Bun/Node)

Project Run/Debug

Key	Mode	Action
`<leader>pr`	n	Run project
`<leader>pd`	n	Debug project
`<leader>p`	n	Run project (quick)

Copilot & AI

Copilot Commands

Key	Mode	Action
`<leader>cp`	n	Open Copilot panel
`<leader>cD`	n	Disable Copilot
`<leader>cE`	n	Enable Copilot
`<leader>cs`	n	Copilot status

Key	Mode	Action
`[[`	n	Previous suggestion (in panel)
`]]`	n	Next suggestion (in panel)
`<CR>`	n	Accept suggestion (in panel)
`rp`	n	Refresh panel
`<M-CR>`	n	Open panel

Inline Suggestions

Key	Mode	Action
`<leader>]`	i	Next suggestion
`<leader>[`	i	Previous suggestion
`<C-]>`	i	Dismiss suggestion

CopilotChat

Key	Mode	Action
`<leader>cc`	n	Toggle CopilotChat window
`<leader>cq`	n	Quick chat (whole buffer)
`<leader>ce`	n, v	Explain code
`<leader>cr`	n, v	Review code
`<leader>cf`	n, v	Fix code
`<leader>co`	n, v	Optimize code
`<leader>cd`	n, v	Generate docs
`<leader>ct`	n, v	Generate tests
`<leader>cm`	n	Select model

Copilot Chat (Visual, personal shortcuts)

Key	Mode	Action
`<leader>zn`	v	Rename variable
`<leader>zc`	n	Open Copilot Chat
`<leader>ze`	v	Explain code
`<leader>zr`	v	Review code
`<leader>zf`	v	Fix code
`<leader>zo`	v	Optimize code
`<leader>zd`	v	Generate docs

Terminal

ToggleTerm

Key	Mode	Action
`<leader>tf`	n	Float terminal
`<leader>th`	n	Horizontal split terminal
`<leader>tv`	n	Vertical split terminal

Terminal Mode

Key	Mode	Action
`<C-h>`	t	Switch to left window
`<C-t>`	t	Close terminal
`<C-\><C-\>`	t	Escape terminal mode

Window Management

Splits

Key	Mode	Action
`<leader>sv`	n	Split vertical
`<leader>sh`	n	Split horizontal
`<leader>se`	n	Make splits equal
`<leader>sx`	n	Close current split

Tabs

Key	Mode	Action
`<leader>to`	n	Open new tab
`<leader>cx`	n	Close current tab
`<leader>tn`	n	Next tab
`<leader>tp`	n	Previous tab
`<leader>tt`	n	Open buffer in new tab

Resize Splits

Key	Mode	Action
`<C-h>`	n	Increase width (+5)
`<C-l>`	n	Decrease width (-5)
`<C-k>`	n	Increase height (+5)
`<C-j>`	n	Decrease height (-5)

Database

vim-dadbod UI

Key	Mode	Action
`<leader>Du`	n	Toggle Database UI
`<leader>Da`	n	Add DB connection
`<leader>Df`	n	Find DB buffer
`<leader>De`	n, v	Execute query
`<leader>Dw`	n	Save query
`<leader>Dr`	n	Rename DB buffer

Quick Connections

Key	Mode	Action
`<leader>Dp`	n	PostgreSQL Docker
`<leader>Dm`	n	MongoDB local
`<leader>DM`	n	MongoDB Docker
`<leader>Di`	n	Redis local
`<leader>DI`	n	Redis Docker

Redis & MongoDB (plugins.lua)

Key	Mode	Action
`<leader>rds`	n	Open Redis
`<leader>rdk`	n	Show Redis keys
`<leader>rdi`	n	Redis info
`<leader>mdb`	n	Open MongoDB
`<leader>mdc`	n	Connect MongoDB
`<leader>mdd`	n	Disconnect MongoDB

LeetCode

Key	Mode	Action
`<leader>lr`	n	Run code
`<leader>ls`	n	Submit code
`<leader>ld`	n	Daily challenge
`<leader>ll`	n	List problems
`<leader>lc`	n	Open console
`<leader>lu`	n	Update cookie
`<leader>lh`	n	Show hints
`<leader>lls`	n	Get latest submission

Text Wrapping

Wrapping Controls

Key	Mode	Action
`<leader>tw`	n	Toggle line wrapping
`<leader>tl`	n	Toggle line break
`<leader>tx`	n	Show 80-char column guide
`<leader>tH`	n	Hide column guide

Format Text

Key	Mode	Action
`<leader>tpg`	n	Format paragraph
`<leader>tf`	v	Format selection
`<leader>tF`	n	Format entire file

Text Width

Key	Mode	Action
`<leader>t80`	n	Set textwidth to 80
`<leader>t100`	n	Set textwidth to 100
`<leader>t120`	n	Set textwidth to 120
`<leader>t0`	n	Disable textwidth

Auto-wrap Controls

Key	Mode	Action
`<leader>ta`	n	Enable auto-wrap text
`<leader>tA`	n	Disable auto-wrap text
`<leader>tc`	n	Enable auto-wrap comments
`<leader>tC`	n	Disable auto-wrap comments
`<leader>ti`	n	Toggle break indent
`<leader>ts`	n	Show break indicator
`<leader>tS`	n	Hide break indicator

Folding (nvim-ufo)

Key	Mode	Action
`zR`	n	Open all folds
`zM`	n	Close all folds
`zr`	n	Open folds except kinds
`zm`	n	Close folds by level
`K`	n	Peek fold or LSP hover

Session Management

Key	Mode	Action
`<leader>sS`	n	Session: Save
`<leader>sR`	n	Session: Restore

Commands

Command	Description
`:Lazy`	Plugin manager
`:Mason`	LSP server manager
`:Navbuddy`	Code navigation
`:Outline`	Symbol outline
`:Neogit`	Git interface
`:DiffviewOpen`	Diff view
`:GrugFar`	Search & replace
`:Octo`	GitHub PRs/issues
`:OverseerRun`	Run tasks
`:ZenMode`	Distraction-free mode
`:Hardtime toggle`	Toggle vim training
`:TSJToggle`	Toggle split/join
`:WordCount`	Show word count (excluding symbols)
`:RunProject`	Run project command
`:DebugProject`	Debug project command

Last Updated: February 10, 2026

14 KiB Raw Permalink Blame History

Complete Keymaps Reference

Table of Contents

General

Personal Workflow

File Management

Editing Shortcuts

Buffer Management

Coding Shortcuts

Quickfix Navigation

Location List Navigation

Navigation (Snacks Picker)

File Navigation

Buffer & Utility Search

Git (Telescope Fallback)

TODO Search

Telescope (Unfiltered)

LSP & Code Intelligence

Navigation (fzf-lua)

Symbols

Code Actions & Rename

Diagnostics

Formatting

File Management

File Explorer (nvim-tree)

Buffer Cycling

Editing

Comments (Comment.nvim)

Substitute (substitute.nvim)

Surround (nvim-surround)

Console.log

TODO Comments

Git

LazyGit

Gitsigns (buffer-local)

Trouble (Diagnostics Panel)

Debugging (DAP)

Debug Control

Debug Navigation

Dynamic Attach

Project Run/Debug

Copilot & AI

Copilot Commands

Copilot Panel Navigation

Inline Suggestions

CopilotChat

Copilot Chat (Visual, personal shortcuts)

Terminal

ToggleTerm

Terminal Mode

Window Management

Splits

Tabs

Resize Splits

Database

vim-dadbod UI

Quick Connections

Redis & MongoDB (plugins.lua)

LeetCode

Text Wrapping

Wrapping Controls

Format Text

Text Width

Auto-wrap Controls

Folding (nvim-ufo)

Session Management

Commands

14 KiB

Raw Permalink Blame History