nvim-setup

Personal Neovim configuration. Fast, minimal, LSP-first.

Prerequisites

• Neovim >= 0.10 (uses vim.loader, snacks.nvim, blink.cmp)
• git — plugin management
• ripgrep (rg) — grep provider
• cargo (Rust) — blink.cmp build
• xclip (WSL only) — clipboard sync

Optional

• llama.cpp + llama-server — built-in AI translation (<leader>at / <leader>aT)
• macism — auto IME switch on macOS

Install

git clone git@github.com:aqua2k1/nvim-setup.git ~/.config/nvim

Open Neovim — lazy.nvim bootstraps itself and installs all plugins on first run. Treesitter core parsers install automatically.

Structure

~/.config/nvim/
├── init.lua                  # Entry point
├── lazy-lock.json            # Plugin version lock
├── lua/
│   ├── option.lua            # Editor options
│   ├── keymap.lua            # Global keymaps
│   ├── autocmd.lua           # Autocommands
│   ├── plugin.lua            # lazy.nvim bootstrap
│   ├── statusline.lua        # Statusline
│   ├── tabline.lua           # Tabline
│   ├── plugins/              # Plugin specs (lazy.nvim)
│   │   ├── cmp.lua           # blink.cmp
│   │   ├── file.lua          # oil.nvim
│   │   ├── git.lua           # gitsigns.nvim
│   │   ├── lsp.lua           # nvim-lspconfig
│   │   ├── markdown.lua      # render-markdown.nvim
│   │   ├── mini.lua          # mini.surround / mini.pairs
│   │   ├── pick.lua          # fzf-lua
│   │   ├── snacks.lua        # snacks.nvim
│   │   ├── term.lua          # toggleterm.nvim
│   │   ├── translate.lua     # Custom translation plugin
│   │   ├── treesitter.lua    # nvim-treesitter
│   │   └── which_key.lua     # which-key.nvim
│   ├── user-plugins/
│   │   └── translate/        # AI translation plugin
│   └── utils/                # Icons, colors, helpers
├── lsp/                      # Per-language LSP configs
│   ├── basedpyright.lua      # Python
│   ├── biome.lua             # JS/TS lint/format
│   ├── clangd.lua            # C/C++
│   ├── gopls.lua             # Go
│   ├── lua_ls.lua            # Lua
│   ├── ruff.lua              # Python lint
│   ├── rust_analyzer.lua     # Rust
│   └── ts_ls.lua             # TypeScript/JavaScript
├── colors/                   # Colorschemes
├── snippets/                 # Code snippets
└── scripts/
    └── llama-translate.sh    # Translation model setup

Keymaps

Leader key: <Space>

File & Search

Key	Description
<leader>ff	Find files (project root)
<leader>fF	Find files (custom directory)
<leader>fg	Find git files
<leader>fo	Recent files
<leader>fw	Live grep (project root)
<leader>fW	Live grep (custom directory)
<leader>fh	Help tags
<leader>fk	Keymaps
<leader>fc	Commands

LSP

Key	Description
gd	Go to definition
K	Hover documentation
grf	Format buffer
<leader>fd	Fzf: definitions
<leader>fr	Fzf: references
<leader>fa	Fzf: code actions
<leader>fs	Fzf: document symbols
<leader>fS	Fzf: workspace symbols

Diagnostics

Key	Description
[d / ]d	Prev / next diagnostic
[e / ]e	Prev / next error
[w / ]w	Prev / next warning

Git (gitsigns)

Key	Description
[h / ]h	Prev / next hunk
[H / ]H	First / last hunk
<leader>gS	Stage hunk
<leader>gR	Reset hunk
<leader>gs	Stage buffer
<leader>gr	Reset buffer
<leader>gb	Blame line
<leader>gB	Blame buffer
<leader>gd	Diff this
ih	Select hunk (operator)

Buffers & Windows

Key	Description
<leader>,	Switch buffer (fzf)
[b / ]b	Prev / next buffer
<leader>bd	Delete buffer
<leader>bv	Vertical split
<leader>bs	Horizontal split
<leader>bc	New empty buffer
<leader>e	Oil file explorer
<C-Up/Down>	Resize height
<C-Left/Right>	Resize width

Terminal

Key	Description
<leader>tv	Terminal (vertical split)
<leader>ts	Terminal (horizontal split)
<leader>tf	Terminal (float)
<leader>tt	Terminal (tab)
<leader>tc	Run command in terminal

In terminal mode: <Esc><Esc> to enter normal mode, <C-w> + hjkl to navigate.

Translation (requires llama.cpp)

Key	Description
<leader>at	Translate to side panel
<leader>aT	Translate & replace in-place

Visual mode: translate selection only. Normal mode: translate entire buffer.

See Translation for setup.

Misc

Key	Description
<C-s>	Save file
gc[oO]	Comment below / above
<leader>q	Toggle quickfix
[q / ]q	Prev / next quickfix
<leader>?	Buffer-local keymaps (which-key)
]] / [[	Jump to next / prev word reference
<F10>	Lazy dashboard

Motion

Key	Description
j / k	gj / gk (visual line)
gh / gl	Line start / end
gm	Match bracket (%)

LSP Setup

LSP servers are auto-enabled from configs in lsp/. Install the corresponding server binary for each language:

Language	Server	Install
Python	basedpyright	pip install basedpyright
Python (lint)	ruff	pip install ruff
C/C++	clangd	package manager (clangd)
Go	gopls	go install golang.org/x/tools/gopls@latest
Rust	rust-analyzer	rustup component add rust-analyzer
TypeScript/JS	typescript-language-server	npm i -g typescript-language-server
JS/TS lint	biome	npm i -g @biomejs/biome
Lua	lua-language-server	package manager

LSP features on attach:

• Auto document highlight on cursor hold
• Float diagnostic on cursor hold (copyable text)
• Diagnostic signs in signcolumn

Translation

Built-in AI translation using local llama.cpp with the Hy-MT2 model.

Setup

# One-time setup
./scripts/llama-translate.sh

This clones llama.cpp, builds it, and downloads the translation model (Hy-MT2-1.8B-Q4_K_M.gguf).

Usage

• <leader>at — translate buffer/selection to a side-panel (scratch buffer)
• <leader>aT — translate and replace buffer/selection in-place

Prompts for target language (en/zh). The model idle-unloads after 10 minutes.

Platform Notes

WSL

Clipboard is automatically routed through xclip. Install it:

sudo apt install xclip

macOS

Input method auto-switching: switches to ABC layout on leaving insert mode, restores previous layout on entering. Requires macism:

brew install macism

SSH

Uses OSC 52 for clipboard when in SSH sessions — no extra setup needed.

Customization

• .nvim.lua or .nvimrc in any project directory is auto-loaded (exrc = true)
• Add new LSP server configs under lsp/ — they are picked up automatically
• Add new lazy plugin specs under lua/plugins/ — imported via { import = "plugins" }