Vim Configuration

Keybindings

General

Mode	Key	Action
-	<Space>	Leader key
Normal	<leader>cd	Open netrw file explorer
Normal	<leader>rl	Reload vimrc
Normal	<leader><leader>	Source current file
Insert	<C-c>	Behave like <Esc>
Normal	Q	Disabled (no Ex mode)

Editing

Mode	Key	Action
Visual	J	Move selected lines down
Visual	K	Move selected lines up
Normal	J	Join lines with cursor preserved
Visual	<leader>p	Paste without overwriting clipboard
Normal/Visual	<leader>d	Delete without overwriting clipboard
Normal	<leader>s	Substitute word under cursor on line
Normal	<leader>x	Make current file executable
Normal	<leader>dg	Generate documentation (Doge)

Navigation

Mode	Key	Action
Normal	<C-d>	Scroll half-page down and center
Normal	<C-u>	Scroll half-page up and center
Normal	n	Next search result (centered)
Normal	N	Previous search result (centered)
Normal	<C-j>	Next location list item
Normal	<C-k>	Previous location list item
Normal	<leader>k	Next location list (centered)
Normal	<leader>j	Previous location list (centered)
Normal	<leader>cl	Close location list

FZF

Mode	Key	Action
Normal	<leader>ff	Find files
Normal	<leader>fo	File history
Normal	<leader>fb	Open buffers
Normal	<leader>fq	Quickfix list
Normal	<leader>fh	Help tags
Normal	<leader>fs	Grep current word under cursor
Normal	<leader>fg	Grep (prompt for input)
Normal	<leader>fc	Grep for current filename
Normal	<leader>fi	Find files in ~/.vim config

Clipboard (OSCYank)

Mode	Key	Action
Normal/Visual	<leader>y	Yank via OSCYank

Dependencies

Required

• git - For plugin management
• vim - 8.0+ recommended
• ripgrep (rg) - Fast grep alternative for FZF
• fd - Fast find alternative for FZF
• fzf - Fuzzy finder

Optional

• rust-analyzer - Rust LSP server
• typescript-language-server - TypeScript/JavaScript LSP
• intelephense - PHP LSP

Installation

Arch Linux

sudo pacman -S git vim ripgrep fd fzf
sudo pacman -S rust-analyzer  # optional
npm install -g typescript-language-server  # optional

NixOS

nix-env -iA nixpkgs.git nixpkgs.vim nixpkgs.ripgrep nixpkgs.fd nixpkgs.fzf
nix-env -iA nixpkgs.rust-analyzer  # optional
npm install -g typescript-language-server  # optional

Gentoo

sudo emerge --ask dev-vcs/git app-editors/vim sys-apps/ripgrep sys-apps/fd app-shells/fzf
sudo emerge --ask dev-lang/rust-bin  # for rust-analyzer
npm install -g typescript-language-server  # optional

Linux (Debian/Ubuntu)

sudo apt install git vim ripgrep fd-find fzf
# Note: fd is called fd-find on Debian/Ubuntu

macOS

brew install git vim ripgrep fd fzf
brew install rust-analyzer  # optional
npm install -g typescript-language-server  # optional

Rust Analyzer

rustup component add rust-analyzer

Setup

1. Clone or copy your Vim configuration

git clone <your-repo> ~/.vim

2. Configure Bash/Zsh

Add to ~/.bashrc or ~/.zshrc:

export FZF_DEFAULT_COMMAND='fd --type f --hidden --follow'

Then source your shell config:

source ~/.bashrc  # or ~/.zshrc

3. Configure fd ignore file

Create ~/.fdignore:

vim ~/.fdignore

Add these lines:

undodir/
plugged/
.git

4. Configure ripgrep ignore file

Create ~/.rgignore:

vim ~/.rgignore

Add the same patterns:

undodir/
plugged/
.git

5. Install plugins

Open Vim and the plugins will auto-install on first run.

Plugin List

Plugin	Purpose
junegunn/fzf	Fuzzy finder
junegunn/fzf.vim	FZF Vim integration
tomasiser/vim-code-dark	Code Dark color scheme
ghifarit53/tokyonight-vim	Tokyo Night color scheme
yegappan/lsp	LSP client
ojroques/vim-oscyank	Copy to system clipboard via OSC52
tpope/vim-commentary	Comment/uncomment code
itchyny/lightline.vim	Statusline

File Structure

~/.vim/
├── vimrc           # Main config (sources all below)
├── options.vim     # Vim options and settings
├── keybinds.vim    # Keybindings
├── plugins.vim     # Plugin manager and plugin list
├── colors.vim      # Color scheme configuration
├── fzf.vim         # FZF configuration
├── lightline.vim   # Lightline configuration
└── plugged/        # Plugin installation directory

Usage

Installing Plugins

Plugins auto-install when you first start Vim. To manually reinstall, delete ~/.vim/plugged and restart Vim.

Updating Plugins

cd ~/.vim/plugged/<plugin-name>
git pull

FZF File Search

The FZF configuration respects .gitignore, .fdignore, and .rgignore files automatically.

Use <leader>ff to search files, <leader>fg to grep content.

LSP Servers

Configure LSP servers in your config. Currently configured:

• Rust: rust-analyzer
• TypeScript/JavaScript: typescript-language-server
• PHP: intelephense

Notes

• The plugin manager is custom and minimal - it auto-installs plugins on Vim startup
• .fdignore and .rgignore prevent searching through plugin directories and undo files
• FZF uses fd for file listing (faster than find) and rg for content search
• OSCYank allows copying to system clipboard even over SSH