2.8 KiB

Raw Blame History

CLAUDE.md

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

Overview

Kickstart-based Neovim config using lazy.nvim as the plugin manager. Single init.lua + modular custom plugins under lua/custom/plugins/.

Plugin Manager

lazy.nvim — plugins defined as lazy specs (return { "owner/repo", ... }).

Update plugins: :Lazy update
Check status: :Lazy
Install/manage LSP tools: :Mason

Structure

init.lua                        — Sections 1–9: foundation → plugins
lua/custom/plugins/init.lua     — Auto-loads all *.lua files in same dir
lua/custom/plugins/*.lua        — User-added plugins (no merge conflicts from upstream)
lua/kickstart/plugins/*.lua     — Optional kickstart examples (indent_line, lint, gitsigns)
lazy-lock.json                  — Lockfile (commit this)

init.lua is organized into do...end blocks by section:

Foundation (options, keymaps, autocmds)
lazy.nvim bootstrap + setup
UI/UX (gitsigns, which-key, mini.nvim, todo-comments)
Search/Navigation (Telescope)
LSP (mason, nvim-lspconfig, fidget)
Formatting (conform.nvim)
Autocomplete & Snippets (blink.cmp + LuaSnip)
Treesitter
Optional examples

Custom Plugins

File	Purpose
`claude.lua`	claudecode.nvim — `<leader>a*` keymaps; depends on snacks.nvim
`lsp.lua`	dbt language server config for SQL/YAML files
`markdown.lua`	live-preview.nvim
`notebook.lua`	molten-nvim (Jupyter), image.nvim (magick_cli), wezterm.nvim
`oil.lua`	oil.nvim file manager via mini.icons
`themes.lua`	gruvbox-medium (active), tokyonight (installed)
`toggle-term.lua`	toggleterm.nvim terminal toggle

LSP

Servers are configured in init.lua:670 via vim.lsp.config(name, server) + vim.lsp.enable(name).
Custom dbt server lives in lua/custom/plugins/lsp.lua — requires dbt-language-server in $PATH.
Lua formatting disabled in lua_ls; formatting delegated to stylua via conform.nvim.

Key Bindings (leader = `<space>`)

<leader>s* — Telescope search
<leader>f — format buffer (conform)
<leader>a* — Claude Code integration
<leader>h* — gitsigns hunk operations
<leader>t* — toggles (inlay hints, blame, word diff)
gr* — LSP actions (rename, code action, references, definitions)

Adding Plugins

Drop a .lua file in lua/custom/plugins/ — auto-required on next start. Use the lazy spec pattern:

return {
  "owner/repo",
  opts = {},
}

Formatting & Linting

Formatter: conform.nvim — <leader>f to format; auto-format on save disabled by default (opt-in per filetype in init.lua:760)
Linter: nvim-lint — runs on BufEnter/BufWritePost/InsertLeave; markdownlint for markdown
Treesitter: auto-installs parsers on FileType event

2.8 KiB Raw Blame History Unescape Escape