Neovim

Rig ships the Neovim config under neovim/.config/nvim. It is built around mini.nvim. External plugins are used where they add clear value: language servers, formatting, Git, GitHub, debugging, HTTP requests, database browsing, and AI workflows.

Architecture

Config files load in numbered order during startup:

~/.config/nvim/
  init.lua             # Bootstrap mini.nvim + MiniDeps
  plugin/
    10_options.lua     # Built-in Neovim behavior
    20_keymaps.lua     # Custom mappings
    30_mini.lua        # Mini module configuration
    40_plugins.lua     # External plugins
  after/
    ftplugin/          # Filetype-specific overrides
    lsp/               # Language server configurations
    snippets/          # Higher priority snippet files
  snippets/            # User-defined snippets

Key Options

Option	Value
Leader key	`Space`
Indent	2 spaces (expandtab)
Text width	100 columns (adapts to window)
Line numbers	Relative
Current line	Highlighted
Undo	Persistent across sessions
Fold method	Indent-based
Search	Incremental, smart case

Leader Key Groups

Leader mappings use <Space> plus a group key and an action key.

Prefix	Group	Examples
`<Leader>a`	AI	Chat, inline, model, buffer context, and review actions
`<Leader>b`	Buffer	`bs` scratch, `ba` alternate, `bw` wipeout
`<Leader>d`	Debug	`db` breakpoint, `dc` continue, `di` step into
`<Leader>e`	Explore/Edit	`ed` directory, `ef` file dir, `ei` init.lua
`<Leader>f`	Find	`ff` files, `fg` grep live, `fh` help tags
`<Leader>g`	Git	`gg` Neogit, `gd` diffview, `gc` commit
`<Leader>l`	Language	`la` actions, `lr` rename, `ls` definition
`<Leader>o`	Octo	GitHub PR/issue integration
`<Leader>r`	Request	HTTP client (Hurl)
`<Leader>s`	Session	`sn` new, `sr` read, `sd` delete
`<Leader>t`	Terminal	Terminal management
`<Leader>v`	Visits	Visited paths history

General Mappings

Shortcut	Action
`[p` / `]p`	Paste above / below current line
`Ctrl+d` / `Ctrl+u`	Half page down / up (centered)
`n` / `N`	Next / prev search result (centered)
`Ctrl+w z`	Zoom toggle
`Ctrl+w r`	Resize to default width
`Esc Esc`	Terminal normal mode
`Ctrl+h/j/k/l`	Navigate between windows
`Alt+h/j/k/l`	Navigate in Insert/Command mode

Color Scheme

Uses Zenbones with:

Stark darkness setting
Transparent background
Italic comments
Custom desaturated palette (subtle leaf, sky, blossom, rose, water tones)
Dark neutral backgrounds (#121212 base)

Plugin Manager

MiniDeps manages all plugins. Loading is split for startup speed:

now() — loads immediately (icons, notifications, statusline, color scheme)
later() — loads after first screen draw
now_if_args() — loads immediately only when opening a file (nvim -- file)

External Plugins

Beyond mini.nvim, the config includes:

Plugin	Purpose
`zenbones.nvim` + `lush.nvim`	Color scheme
`nvim-treesitter`	Syntax highlighting and textobjects
`nvim-lspconfig` + `mason.nvim`	Language server management
`conform.nvim`	Format on save (Stylua, Biome, Ruff)
`neogit` + `gitsigns` + `diffview`	Git interface
`octo.nvim`	GitHub PRs and issues
`hurl.nvim`	HTTP client
`nvim-dap` + `nvim-dap-ui`	Debugging (JS, Go)
`codecompanion.nvim`	AI chat and inline editing
`0x0-chat.nvim`	0x0 chat, inline edit, and review client
`0x0-completion.nvim`	0x0 ghost-text completion
`vim-dadbod` + `vim-dadbod-ui`	Database client

LSP Servers

Configured and auto-installed via Mason:

Server	Languages
`ts_ls`	TypeScript / JavaScript (skipped in Deno projects)
`denols`	Deno
`lua_ls`	Lua (disabled by default, enable via `<Leader>lm`)
`astro`	Astro
`biome`	JS/TS/JSON/CSS/HTML linting
`yamlls`	YAML

Getting Started

Modules

Reference

Architecture

Key Options

Leader Key Groups

General Mappings

Color Scheme

Plugin Manager

External Plugins

LSP Servers

​Architecture

​Key Options

​Leader Key Groups

​General Mappings

​Color Scheme

​Plugin Manager

​External Plugins

​LSP Servers

Architecture

Key Options

Leader Key Groups

General Mappings

Color Scheme

Plugin Manager

External Plugins

LSP Servers