nvim-config

Scope

• config/nvim/

Rules

• Follow the existing module layout and plugin organization.
• Keep changes scoped to requested behavior; avoid unrelated cleanup.
• Prefer clear mappings/options over dense abstractions.
• Keep plugin-specific settings near the plugin configuration.
• Follow repo workflow gates from config/opencode/AGENTS.md for non-trivial changes.

When to use

• Adding/updating Neovim plugins and settings
• Adjusting keymaps or editor behavior
• Refactoring Neovim config structure in this repo

Workspace testing

Run Neovim against workspace config from the repo root:

XDG_CONFIG_HOME="$PWD/config" nvim

Run with isolated workspace-local data/state/cache:

mkdir -p .tmp/xdg-data .tmp/xdg-state .tmp/xdg-cache
XDG_CONFIG_HOME="$PWD/config" \
XDG_DATA_HOME="$PWD/.tmp/xdg-data" \
XDG_STATE_HOME="$PWD/.tmp/xdg-state" \
XDG_CACHE_HOME="$PWD/.tmp/xdg-cache" \
nvim

Smoke-test startup without opening UI:

XDG_CONFIG_HOME="$PWD/config" nvim --headless "+qa"