.dotfiles

A comprehensive dotfile configuration for Linux systems featuring Neovim, Tmux, and Zsh with Oh My Zsh. Uses GNU Stow for automatic symlinking.

Table of Contents

• Prerequisites
• Quick Start
• Setup Instructions
  • Neovim
  • Oh My Zsh
• Reference Guide
  • Vim Motions & Commands
  • Search & Replace
  • File Operations
• Custom Keymaps
  • Essential Shortcuts
  • File Navigation (Telescope)
• Plugin Configuration
  • Harpoon - Quick File Navigation
  • Vim-Surround - Edit Surrounding Characters
  • Undotree - Visualize Undo History
  • LSP Features
  • Auto-completion (nvim-cmp)
  • GitHub Copilot
• Tmux Configuration
  • Key Settings
  • Basic Commands
• Getting Help
  • Vim Help System
  • LSP Management
• Plugin Management
• External Tools

Prerequisites

• GNU Stow - for managing dotfile symlinks
• Git
• Curl

Quick Start

cd .dotfiles
chmod +x ./install.sh
./install.sh

Setup Instructions

Neovim

1. Install the latest Neovim:

   curl -LO https://github.com/neovim/neovim/releases/latest/download/nvim.appimage
   chmod u+x nvim.appimage
   sudo ln -s ./nvim.appimage /usr/local/bin/nvim

2. Install Packer (plugin manager):

   git clone --depth 1 https://github.com/wbthomason/packer.nvim \
     ~/.local/share/nvim/site/pack/packer/start/packer.nvim

3. Sync plugins in Neovim:

   :PackerSync
   

Oh My Zsh

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

Reference Guide

Vim Motions & Commands

Modes

• Normal mode - Navigate and manipulate text
• Insert mode - Type and edit text
• Visual mode - Select text

Entering Insert Mode

Key	Action
i	Insert before cursor
I	Insert at beginning of line
a	Insert after cursor
A	Insert at end of line
o	New line below and insert
O	New line above and insert

Visual Mode

Key	Action
v	Character-wise visual
V	Line-wise visual
<C-v>	Block visual

Movement

Key	Action
h j k l	Left, down, up, right
w	Next word start
b	Previous word start
e	End of word
9	Beginning of line (remapped from 0)
0	End of line (remapped from $)
gg	File start
G	File end
<C-d>	Scroll down half page
<C-u>	Scroll up half page
{	Previous paragraph
}	Next paragraph

Text Objects

Command	Action
ci{	Change inside braces
ca(	Change around parentheses
di"	Delete inside quotes
da'	Delete around single quotes
yt{	Yank until next {
dt'	Delete until next '

Operations

Key	Action
x	Delete character
d	Delete (combine with motions)
y	Yank/copy (combine with motions)
p	Paste after
P	Paste before
u	Undo
<C-r>	Redo

Search & Replace

Basic Search

/{pattern}     " Search forward
?{pattern}     " Search backward
n              " Next match
N              " Previous match
*              " Search word under cursor forward
#              " Search word under cursor backward

Find & Replace

:%s/{search}/{replace}/g         " Replace all in file
:%s/{search}/{replace}/gc        " Replace all with confirmation
:{start},{end}s/{search}/{replace}/g  " Replace in range

Search Settings

Our configuration includes these search enhancements:

set ignorecase smartcase  " Smart case sensitivity
set incsearch hlsearch    " Incremental search with highlighting

Clear search highlighting: <leader><CR>

File Operations

:r {filename}        " Insert file contents
:r !{command}        " Insert command output
<leader>ps          " Project-wide search (grep)

Custom Keymaps

Essential Shortcuts

Key	Action
gV	Reselect last visual selection
Y	Yank to end of line
<leader><leader>	Switch between last two buffers
<leader><CR>	Clear search highlighting

File Navigation (Telescope)

Key	Action
<leader>pf	Fuzzy find files
<leader>gf	Find Git tracked files

Plugin Configuration

Harpoon - Quick File Navigation

Key	Action
<leader>a	Add file to Harpoon
<C-h> <C-t> <C-n> <C-s>	Navigate marked files
<C-e>	Open Harpoon quick menu

Vim-Surround - Edit Surrounding Characters

Command	Action
cs"'	Change " to '
cs({	Change ( to {
ds'	Delete surrounding '
ysiw]	Surround word with []
yss"	Surround line with ""

Undotree - Visualize Undo History

Key	Action
<leader>u	Toggle undo tree

LSP Features

Key	Action
gd	Go to definition
gD	Go to declaration
gi	Go to implementation
go	Go to type definition
gr	List references
K	Show documentation
gs	Show signature help
<F2>	Rename symbol
<F3>	Format buffer
gl	Show diagnostics
[d ]d	Navigate diagnostics

Auto-completion (nvim-cmp)

Key	Action
<C-y>	Accept completion
<C-e>	Cancel completion
<Up> <Down>	Navigate completions

GitHub Copilot

Key	Action
<C-y>	Accept suggestion
<C-]>	Dismiss suggestion
<M-[> <M-]>	Cycle suggestions
<M-Right>	Accept next word
<M-C-Right>	Accept next line

Tmux Configuration

Key Settings

• Prefix key: Ctrl-a (instead of default Ctrl-b)
• Escape time: Instant key registration
• New windows: Open in current path
• Auto-renumber: Windows renumber after closing
• History: 10,000 line scrollback buffer

Basic Commands

# Sessions
tmux new -s session_name    # Create named session
tmux attach -t session_name # Attach to session
tmux list-sessions         # List sessions

# Windows & Panes
Ctrl-a c                   # New window
Ctrl-a %                   # Split vertically
Ctrl-a "                   # Split horizontally
Ctrl-a [0-9]              # Switch to window number

Getting Help

Vim Help System

Type	Prefix	Example
Normal mode	(none)	:help x
Visual mode	v_	:help v_u
Insert mode	i_	:help i_META
Command-line	:	:help :quit
Options	'	:help 'textwidth'

LSP Management

:LspInstall {server}   " Install LSP server
:Mason                 " Open Mason package manager
:Copilot               " Copilot commands

Plugin Management

Plugins are managed with Packer. After making changes:

1. Source the config: :so
2. Sync plugins: :PackerSync

External Tools

Fuzzy Finding with FZF

ps aux | fzf          # Search processes with fuzzy finding