nvim/CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Overview

Personal Neovim configuration using lazy.nvim as the plugin manager. All Lua code lives under the holger namespace in lua/holger/.

Architecture

Entry point: init.lua loads two modules:

• holger.core — Neovim options and keymaps (lua/holger/core/)
• holger.lazy — bootstraps lazy.nvim and loads all plugins

Plugin loading: lua/holger/lazy.lua calls require("lazy").setup() with two import paths:

• holger.plugins — all files in lua/holger/plugins/ (each returns a lazy.nvim spec table)
• holger.plugins.lsp — files in lua/holger/plugins/lsp/

Adding a plugin: Create a new file in lua/holger/plugins/ that returns a lazy.nvim spec table. It will be auto-imported.

Key Configuration

• Leader key: <Space>
• Colorscheme: catppuccin
• Indentation: 2 spaces, expandtab

LSP Stack

• mason.nvim — installs LSP servers and tools
• mason-lspconfig.nvim — bridges Mason with nvim-lspconfig; auto-installs: ts_ls, html, cssls, tailwindcss, lua_ls, pyright, eslint
• mason-tool-installer.nvim — installs formatters/linters: prettier, stylua, isort, black, pylint, eslint_d
• cmp-nvim-lsp (lua/holger/plugins/lsp/lspconfig.lua) — sets up capabilities via vim.lsp.config("*", ...) (native Neovim LSP API)

Formatting & Linting

• conform.nvim — formats on save; <leader>mp to format manually
  • JS/TS/CSS/HTML/JSON/YAML/Markdown/GraphQL → prettier
  • Lua → stylua
  • Python → isort + black
• nvim-lint — lints on BufEnter/BufWritePost/InsertLeave; <leader>l to trigger manually
  • Python → pylint

Key Keymaps

Key	Action
jk (insert)	Exit insert mode
<leader>ee	Toggle nvim-tree file explorer
<leader>ef	Toggle explorer on current file
<leader>ff	Telescope find files
<leader>fs	Telescope live grep
<leader>fr	Telescope recent files
<leader>fc	Grep string under cursor
s / S	Flash jump / Flash treesitter jump
<leader>mp	Format file (conform)
<leader>l	Trigger linting
<leader>sv/sh	Split window vertical/horizontal
<leader>nh	Clear search highlights

Notable Plugins

• telescope.nvim — fuzzy finder with fzf-native extension
• nvim-treesitter — syntax highlighting and incremental selection (<C-space>)
• nvim-cmp — completion engine with LuaSnip snippets and LSP/buffer/path sources
• flash.nvim — enhanced motion with jump labels; integrated into / search
• neorg — note-taking, workspace at ~/notes
• auto-session — automatic session save/restore
• which-key — displays keybinding hints
• fugitive — Git integration
• trouble.nvim — diagnostics list