kickstart.nvim/README.md

nvim

Personal Neovim config, originally forked from kickstart.nvim and broken into per-plugin files. Lives at ~/.config/nvim.

Layout

init.lua                    -- options, global keymaps, autocmds, lazy bootstrap
lua/custom/
├── zed-keymaps.lua         -- Zed-parity bindings + task spawners
├── health.lua              -- :checkhealth kickstart
└── plugins/*.lua           -- one file per plugin; auto-imported by lazy
lazy-lock.json              -- committed, pinned plugin versions

No build/test step. Changes take effect on nvim restart (or :source % / :Lazy reload <plugin>). Lua is formatted by stylua per .stylua.toml (2-space, single quotes, 160-col).

Install

Requires Neovim stable or nightly, plus: git, make, a C compiler, ripgrep, a clipboard tool, and a Nerd Font. Optional: npm, go, python, java for the respective LSPs.

git clone <your-fork> "${XDG_CONFIG_HOME:-$HOME/.config}"/nvim
nvim

On first launch lazy.nvim installs every plugin under lua/custom/plugins/, and Mason installs the LSPs/formatters listed in lsp.lua. Run :Lazy, :Mason, :checkhealth to verify.

Editor defaults (init.lua)

• Leader and localleader are Space.
• relativenumber, cursorline, signcolumn=yes, scrolloff=8, splitright/splitbelow.
• spell on (en_us); undofile on; inccommand=split for live substitution preview.
• ignorecase + smartcase; timeoutlen=300, updatetime=250.
• Per-filetype colorcolumn: python 80, lua 100, rust 100, go 120, java 120. Off everywhere else.
• Yank highlight on TextYankPost; clipboard synced to unnamedplus after UI ready.

Plugins

File	Plugin	Purpose
lsp.lua	nvim-lspconfig + Mason + fidget.nvim + lazydev	LSP for clangd, gopls, pyright, ruff, lua_ls; auto-installs stylua, jdtls, google-java-format
cmp.lua	blink.cmp	Completion (capabilities fed to LSP)
conform.lua	conform.nvim	Format on save (500ms timeout, LSP fallback; off for c/cpp/json/xml/html)
lint.lua	nvim-lint	Linting
treesitter.lua	nvim-treesitter (main branch) + textobjects	Highlight, indent, function/class/param motions
treesitter-context.lua	nvim-treesitter-context	Sticky context header
telescope.lua	telescope.nvim + fzf-native + ui-select	Fuzzy finder
neo-tree.lua	neo-tree.nvim	File tree (auto-opens on nvim / nvim <dir>)
harpoon.lua	harpoon2	Quick file marks
gitsigns.lua	gitsigns.nvim	Gutter signs, line blame (300ms), hunk actions
lazygit.lua	lazygit.nvim	Lazygit popup
trouble.lua	trouble.nvim	Diagnostics / refs / qflist panel
todo.lua	todo-comments	Highlight TODO/FIX/HACK/...
toggleterm.lua	toggleterm.nvim	Float / split terminals
tmux.lua	smart-splits.nvim	<C-hjkl> nav across nvim splits ↔ zellij panes
mini.lua	mini.ai, mini.move, mini.notify, mini.starter, mini.statusline	Misc utilities + statusline
leap.lua	flash.nvim	s/S motions, remote ops
persistence.lua	persistence.nvim	Per-cwd auto session
which-key.lua	which-key.nvim	Keybind popup
copilot.lua	copilot.vim	Inline suggestions (accept on <M-Tab>)
copilot-chat.lua	CopilotChat.nvim	In-editor chat
render-markdown.lua	render-markdown.nvim	Pretty markdown in buffer
markdown-preview.lua	markdown-preview.nvim	Browser preview
gruvbox.lua	gruvbox	Colorscheme
neoscroll.lua	neoscroll.nvim	Smooth scrolling
illuminate.lua	vim-illuminate	Highlight word under cursor
indent_line.lua	indent-blankline	Indent guides
autopairs.lua	nvim-autopairs	Bracket pairs
nvim-surround.lua	nvim-surround	Surround motions
dressing.lua	dressing.nvim	Better vim.ui prompts
sleuth.lua	vim-sleuth	Auto-detect indent
java.lua	nvim-jdtls	Java LSP wrapper
debug.lua	nvim-dap + UI	Debugger

Keymaps

Movement & editing (init.lua / zed-keymaps.lua)

Key	Mode	Action
;	n	: (command mode)
<Esc>	n	Clear search highlight
oo / OO	n	Open blank line below/above without entering insert
<leader>p	x	Paste without clobbering register
<A-j> / <A-k>	n/v	Move line/selection down/up
<C-h/j/k/l>	i	Arrow keys in insert
<C-h/l/b/f/k/j>	c	Word/char nav in command line
<C-w>	i	Delete previous word
s / S / r / R	n/x/o	flash.nvim jump / treesitter / remote

Windows, buffers, tasks

Key	Action
<C-h/j/k/l>	Focus split — falls through to zellij pane
<A-1>..<A-9>	Jump to buffer slot 1..9 (vim.t.bufs[i])
<leader>x	Close current buffer
<leader>t / <leader>T	Floating / horizontal toggleterm
<C-\>	Open mapping for toggleterm
<leader>gh	gh dash in floating pane
<leader>kk	k9s
<leader>bb	bruno tests
<leader>uu / <leader>dd	make up / make down in restopay/
<leader>aa	Refresh Athenz cert + AWS creds for external-factory

Finder (<leader>f…)

Key	Action
<leader>ff	Files
<leader>fg	Live grep
<leader>fw	Grep current word
<leader>fd	Diagnostics
<leader>fh	Help tags
<leader>fk	Keymaps
<leader>fs	Telescope builtins
<leader>fr	Resume last picker
<leader>f.	Recent files
<leader>fc	Commands
<leader>fe	Workspace symbols
<leader><leader>	Buffers
<leader>/	Fuzzy find in current buffer
<leader>s/	Live grep in open buffers
<leader>sn	Find files in nvim config

LSP (set on LspAttach, plus zed-parity)

Key	Action
gd / gr / gI	Definitions / refs / implementations (telescope)
gi	Implementations (lowercase zed-style)
gD	Declaration
<leader>D	Type definition
<leader>ds / <leader>ws	Document / workspace symbols
<leader>rn or F2	Rename
<leader>ca or <leader>.	Code action
<leader>th	Toggle inlay hints (on by default for Go)
<leader>q	Diagnostics → loclist
<leader>f	Format buffer (conform)

Git

Key	Action
]c / [c	Next / prev hunk
<leader>hs / <leader>hr	Stage / reset hunk (works in visual)
<leader>hS / <leader>hR	Stage / reset buffer
<leader>hu	Undo stage hunk
<leader>hp	Preview hunk
<leader>hb	Blame current line
<leader>hd / <leader>hD	Diff vs index / last commit
<leader>tb / <leader>tD	Toggle inline blame / deleted markers
gb	Full-buffer blame

Harpoon

Key	Action
<leader>ha	Add current file
<leader>hh	Toggle harpoon menu
<leader>1..<leader>4	Jump to slot 1..4
[h / ]h	Prev / next entry

Trouble (<leader>x…)

Key	Action
<leader>xx	Workspace diagnostics
<leader>xX	Buffer diagnostics
<leader>xs	Symbols
<leader>xr	LSP refs/defs (right)
<leader>xl / <leader>xq	Loclist / quickfix

Neo-tree

Key	Action
\ or <leader>e	Reveal file in tree
(inside tree) h / l / <tab>	Collapse / expand+open / smart-toggle
(inside tree) T	Trash file (via trash CLI)

Treesitter textobjects

af/if function, ac/ic class, aa/ia parameter, al/il loop; ]m/[m/]M/[M move between functions.

Copilot / chat

Key	Action
<M-Tab> (insert)	Accept Copilot suggestion
<leader>cc / <leader>ce / <leader>cf / <leader>cr / <leader>ct / <leader>cm	Chat / explain / fix / review / tests / commit-msg

Sessions (persistence.nvim)

Key	Action
<leader>qs	Load session for cwd
<leader>ql	Load last session
<leader>qd	Stop saving current session

LSP & formatting notes

• gopls uses -tags=integration, gofumpt, staticcheck, full inlay hints; useany/unusedparams on, shadow off.
• Go imports run as a source.organizeImports code action on BufWritePre for *.go.
• pyright lint is suppressed and its organize-imports disabled; ruff handles lint + organize + format. ruff's hover is disabled — pyright provides hover.
• lua_ls: callSnippet = 'Replace'; lazydev loads vim.uv types.
• Per-ft formatters: stylua (lua), ruff_organize_imports + ruff_format (python), google-java-format (java), terraform_fmt, prettier/xmlformatter (xml), prettierd/prettier (js). Format-on-save off for c/cpp/json/xml/html.

Adding a plugin

Drop a new file in lua/custom/plugins/ returning a lazy spec. No central manifest. After edits, run :Lazy sync (or restart) and commit lazy-lock.json alongside the spec.

FAQ

• Where do LSP keymaps live? In the LspAttach autocmd in lsp.lua. Add new buffer-local LSP bindings there, not globally.
• Why doesn't <C-h/j/k/l> move splits in some configs? They're owned by smart-splits.nvim; at a split edge they forward to the zellij pane (multiplexer_integration = 'zellij').
• Uninstall: see lazy.nvim uninstall.
• Run alongside another config: NVIM_APPNAME=nvim-other nvim.