# Vim Config

Lightweight vim config.

## Install

```bash
git clone git@github.com:itme-brain/vim.git ~/.vim
vim  # plugins auto-install on first run
```

Requires `curl` and `git` for vim-plug bootstrap. On NixOS this is managed via home-manager instead.

## How it works

- Vim auto-loads `~/.vim/vimrc` — no symlinks needed
- [vim-plug](https://github.com/junegunn/vim-plug) auto-downloads itself via curl on first run if missing
- Missing plugins are installed with `PlugInstall --sync` on `VimEnter`, then the vimrc is re-sourced
- `silent! colorscheme` suppresses errors if the colorscheme hasn't been fetched yet (e.g. offline first run)
- Undo history persists to `~/.vim/undodir` across sessions (`undofile`)

## Plugins

| Plugin | What it does |
|--------|-------------|
| base16-vim | Colorscheme (onedark) |
| vim-surround | Surround text objects (`cs"'`, `ysiw]`) |
| auto-pairs | Auto-close brackets/quotes |
| fzf + fzf.vim | Fuzzy finder (files, buffers, grep) |
| vim-log-highlighting | Syntax highlighting for log files |
| vim-highlightedyank | Flash feedback on yank |
| lightline.vim | Statusline |
| vim-fugitive | Git commands (`:Git status`, `:Git blame`, etc.) |
| vim-signify | Git diff signs in the gutter |
| vim-anzu | Search match count in statusline |

## Keybinds

Leader is `Space`.

### File explorer & search
| Key | Action |
|-----|--------|
| `<leader>e` | Toggle netrw sidebar |
| `<leader>/` | Ripgrep search |
| `<leader>ff` | Find files (fzf) |
| `<leader>fp` | Recent files (fzf) |
| `<leader>fb` | Open buffers (fzf) |
| `<leader>?` | Command history (fzf) |

### Buffers
| Key | Action |
|-----|--------|
| `H` / `L` | Previous / next buffer |
| `<leader>bd` | Force close buffer |

### Windows
| Key | Action |
|-----|--------|
| `<C-h/j/k/l>` | Navigate windows (skips netrw) |
| `<C-Arrow>` | Resize windows |
| `<leader>wh` | Horizontal split |
| `<leader>wv` | Vertical split |
| `<leader>wd` | Close window |

### Git
| Key | Action |
|-----|--------|
| `<leader>gs` | Git status |
| `<leader>gl` | Git log |
| `<leader>gd` | Git diff |
| `<leader>gb` | Git blame |
| `<leader>ga` | Git add |
| `<leader>gc` | Git commit |

### Other
| Key | Action |
|-----|--------|
| `<Esc>` | Clear search highlight |
| `<C-U>` / `<C-D>` | Scroll half-page (centered) |
| `<` / `>` (visual) | Indent and keep selection |
| `<leader>t` | Terminal (bottom split) |
| `<leader>ts` | Insert timestamp |
| `<leader>pu` | PlugUpdate |
| `<leader>pi` | PlugInstall |