vimconf

A redistributable Neovim configuration for Go, Python, Git-heavy editing, terminal workflows, and AI CLI tools such as Codex and Claude.

This repo is intentionally self-contained. The Neovim config lives in nvim/, scripts live in scripts/, and user-facing documentation lives in docs/.

Requirements

• Neovim 0.10 or newer
• Git
• A Nerd Font for icons
• Go toolchain for Go development
• Python 3 for Python development
• Optional: ripgrep, fd, node, npm, codex, claude, gh

Install

From this repository:

./scripts/install.sh

Then start Neovim:

nvim

The first launch bootstraps lazy.nvim, installs plugins, then installs configured language tools through Mason.

Update

./scripts/update.sh

Inside Neovim:

:Lazy sync
:Mason

Layout

• nvim/init.lua loads the config.
• nvim/lua/vimconf/core/ contains options, keymaps, commands, and autocommands.
• nvim/lua/vimconf/plugins/ contains plugin specs grouped by feature.
• nvim/after/ftplugin/ contains language-specific local settings.
• docs/USAGE.md explains commands, keymaps, tools, and workflows.
• scripts/install.sh links this config into the normal Neovim config path.
• scripts/update.sh updates this repo and installed plugins.
• scripts/check.sh performs basic local health checks.

Philosophy

The leader key is Space. Most commands are discoverable through which-key after pressing Space.

This config avoids machine-specific secrets and does not assume one AI vendor. It gives you terminal shortcuts for local AI CLIs and keeps editor behavior useful even when those CLIs are not installed.