# LazyVim Plugin Cheatsheet

Quick reference for the custom plugins in your configuration.

---

## Git Tools (`lua/plugins/git.lua`)

### git-blame.nvim
Shows git blame information at the end of each line.

**Commands:**
- `:GitBlameToggle` - Toggle git blame on/off
- `:GitBlameEnable` - Enable git blame
- `:GitBlameDisable` - Disable git blame
- `:GitBlameOpenCommitURL` - Open commit in browser
- `:GitBlameCopySHA` - Copy commit SHA to clipboard

**Default:** Enabled on startup

---

### diffview.nvim
Advanced git diff and history viewer.

**Key Bindings:**
- `<leader>gd` - Open diff view of current changes
- `<leader>gh` - View current file's git history
- `<leader>gH` - View entire repo's git history

**Commands:**
- `:DiffviewOpen` - Open diff view
- `:DiffviewClose` - Close diff view
- `:DiffviewFileHistory` - View repo history
- `:DiffviewFileHistory %` - View current file history
- `:DiffviewRefresh` - Refresh the diff view

**In Diffview:**
- `]c` / `[c` - Jump to next/previous change
- `<tab>` / `<S-tab>` - Select next/previous file
- `gf` - Open file in new tab
- `q` - Close diffview

---

## UI Enhancements (`lua/plugins/ui-enhancements.lua`)

### render-markdown.nvim
Renders markdown with better formatting while editing.

**Features:**
- Automatically styles headers, lists, code blocks
- Works only in markdown files
- No commands needed - always active in `.md` files

**Toggle:** Disable by setting `enabled = false` in config

---

### hlargs.nvim
Highlights function arguments with different colors.

**Features:**
- Automatically highlights function parameters
- Helps distinguish arguments visually
- Works across all supported languages

**No commands needed** - always active

---

### twilight.nvim
Dims inactive code to focus on current block.

**Key Bindings:**
- `<leader>ut` - Toggle Twilight mode

**Commands:**
- `:Twilight` - Toggle twilight
- `:TwilightEnable` - Enable twilight
- `:TwilightDisable` - Disable twilight

**Best for:** Focusing on specific functions or code blocks

---

### theme-hub.nvim
Browse and switch colorschemes with live preview.

**Key Bindings:**
- `<leader>uT` - Open Theme Hub

**Commands:**
- `:ThemeHub` - Open theme browser

**In Theme Hub:**
- `j` / `k` - Navigate themes
- `<CR>` - Apply selected theme
- `<Esc>` / `q` - Close without applying

---

## Search Tools (`lua/plugins/search.lua`)

### nvim-hlslens
Enhanced search highlighting with match counts.

**Key Bindings:**
- `n` - Next search result (enhanced)
- `N` - Previous search result (enhanced)
- `*` - Search word under cursor (enhanced)
- `#` - Search word backward (enhanced)
- `g*` / `g#` - Search without word boundaries

**Features:**
- Shows match count (e.g., "3/15")
- Floating window near cursor
- Automatically clears after cursor movement

---

### search-replace.nvim
Advanced multi-buffer search and replace.

**Single Buffer Operations:**
- `<leader>rs` - Search/replace in visual selection
- `<leader>ro` - Search/replace (open prompt)
- `<leader>rw` - Search/replace word under cursor
- `<leader>rW` - Search/replace WORD under cursor
- `<leader>re` - Search/replace expression
- `<leader>rf` - Search/replace filename

**Multi-Buffer Operations:**
- `<leader>rbs` - Search/replace selections (all buffers)
- `<leader>rbo` - Search/replace open (all buffers)
- `<leader>rbw` - Search/replace word (all buffers)
- `<leader>rbW` - Search/replace WORD (all buffers)
- `<leader>rbe` - Search/replace expression (all buffers)
- `<leader>rbf` - Search/replace filename (all buffers)

**Commands:**
- `:SearchReplaceSingleBuffer` - Single buffer mode
- `:SearchReplaceMultiBuffer` - Multi-buffer mode
- `:SearchReplaceWithinVisualSelection` - Within selection

---

## File Type Tools (`lua/plugins/filetypes.lua`)

### csvview.nvim
Formats and aligns CSV/TSV files for better readability.

**Key Bindings:**
- `<leader>cv` - Toggle CSV view (only in CSV/TSV files)

**Commands:**
- `:CsvViewEnable` - Enable CSV formatting
- `:CsvViewDisable` - Disable CSV formatting
- `:CsvViewToggle` - Toggle CSV view

**File Types:** Automatically works with `.csv` and `.tsv` files

---

## Built-in LazyVim Extras

These are enabled via `lazyvim.json` and have their own keybindings:

### Telescope
- `<leader>ff` - Find files
- `<leader>fg` - Live grep
- `<leader>fb` - Browse buffers
- `<leader>fh` - Help tags

### Neo-tree
- `<leader>e` - Toggle file explorer
- `<leader>E` - Toggle file explorer (current file)

### Harpoon2
- `<leader>h` - Harpoon menu
- `<leader>a` - Add file to harpoon

### Aerial (Code Outline)
- `<leader>cs` - Open symbols outline

### Project Management
- `<leader>fp` - Find project

---

## Tips

1. **Enable/Disable Plugins:** Edit the respective file in `lua/plugins/` and set `enabled = false`
2. **View All Keymaps:** Press `<leader>sk` (search keymaps) in Telescope
3. **Check Plugin Status:** Run `:Lazy` to see installed plugins
4. **Update Plugins:** Run `:Lazy update`
5. **View Help:** Most plugins have `:help <plugin-name>` documentation

---

## Plugin Files Location

```
~/.config/nvim/lua/plugins/
├── git.lua              # Git blame & diffview
├── ui-enhancements.lua  # Render-markdown, hlargs, twilight, theme-hub
├── search.lua           # Hlslens, search-replace
├── filetypes.lua        # CSV viewer
└── markdown.lua         # Markdown-specific config
```