neo-vim

Installation

Option 1: Direct One-Liner (Recommended)

git clone --depth 1 https://github.com/cavaldos/neo-vim /tmp/neo-vim && { [ -d ~/.config/nvim ] && mv ~/.config/nvim ~/.config/nvim-backup-$(date +%s) || true; } && mkdir -p ~/.config && cp -r /tmp/neo-vim/nvim ~/.config/ && rm -rf /tmp/neo-vim

Option 2: Manual Steps

# Clone repo
git clone https://github.com/cavaldos/neo-vim

cd neo-vim
# Backup old config (if exists)
mv ~/.config/nvim ~/.config/nvim-backup

# Copy new config
cp -r ./nvim ~/.config/nvim

Uninstallation

# Remove config
rm -rf ~/.config/nvim
rm -rf ~/.local/state/nvim
rm -rf ~/.local/share/nvim
rm -rf ~/.cache/nvim

Launch Neovim - Lazy will automatically install all plugins.

Plugins

Plugin	Description
alpha-nvim	Startup dashboard
nvim-autopairs	Auto-close brackets/quotes
Comment.nvim	Smart code commenting
fzf + fzf.vim	Legacy fuzzy finder
gitsigns.nvim	Git decorations
nvim-treesitter	Syntax highlighting
nvim-lspconfig	LSP config
mason.nvim	LSP package manager
mason-lspconfig.nvim	Mason + lspconfig bridge
neoformat	Code formatting
neo-tree.nvim	File explorer
blink.cmp	Autocompletion
telescope.nvim	Modern fuzzy finder
which-key.nvim	Keybinding hints
base46	Themes
copilot.vim	GitHub Copilot AI
nvim-dap	Debug Adapter Protocol client
nvim-dap-ui	Debugging UI panels
nvim-dap-virtual-text	Inline debug values
mason-nvim-dap.nvim	Mason adapter installer
nvim-dap-python	Python debugging support
aerial.nvim	Code outline
noice.nvim	Enhanced cmdline UI
floaterm	Terminal toggle

---

Keybindings

Conventions

Symbol	Key
<leader>	, (comma)
<D>	Command (⌘)
<C>	Control
<CR>	Enter/Return

---

🚀 General

Key	Action
<D-z>	Undo
<D-S-Z>	Redo
<leader>cm	Copy messages to clipboard
<leader>tb	Toggle background transparency
<leader>?	Show buffer local keymaps

---

📁 File Explorer (Neo-tree)

Key	Action
<C-n>	Toggle Neo-tree

---

🔍 Telescope (Fuzzy Finder)

Key	Action
<leader>ff	Find files
<leader>fg	Live grep
<leader>fb	Buffers
<leader>fc	Commands
<leader>fr	Recent files
<leader>fF	Git files (or regular files if not in git repo)

Git Pickers

Key	Action
<leader>gs	Git status
<leader>gC	Git commits
<leader>gc	Buffer commits
<leader>gb	Git branches
<leader>gS	Git stash

LSP Pickers

Key	Action
<leader>ls	Document symbols
<leader>lS	Workspace symbols
<leader>lr	LSP references
<leader>li	LSP implementations
<leader>ld	Document diagnostics
<leader>lD	Workspace diagnostics

Theme

Key	Action
<leader>th	Choose colorscheme

---

🔍 FZF (Legacy)

Key	Action
<leader>zf	Files
<leader>zg	Live grep (rg)
<leader>zG	Git files
<leader>zs	Git status files
<leader>za	Grep (ag)
<leader>zb	Buffers
<leader>zh	Recent files
<leader>z;	Command history
<leader>z/	Search history
<leader>zl	BLines
<leader>zz	Lines (all buffers)
<leader>zt	Tags
<leader>zT	BTags
<leader>zm	Marks
<leader>zq	Quickfix
<leader>zw	Windows
<leader>zj	Jumps
<leader>zc	Changes
<leader>ze	Locate (system)
<leader>zk	Keymaps
<leader>zo	Commands
<leader>zn	Snippets
<leader>zC	Colorschemes
<leader>zF	Filetypes
<leader>zH	Help tags

---

🤖 Copilot (AI)

Key	Action
<Tab>	Accept suggestion (or insert literal)
<C-J>	Accept suggestion
<C-K>	Next suggestion
<C-H>	Previous suggestion
<C-L>	Dismiss suggestion

---

DAP Debugging

Key	Action
<F5>	Continue / Start debugging
<F6>	Step over
<F7>	Step into
<F8>	Step out
<F9>	Toggle breakpoint
<F10>	Terminate debugging
<leader>db	Toggle breakpoint
<leader>dc	Continue
<leader>dr	Open DAP REPL
<leader>dl	Run last debug session
<leader>du	Toggle DAP UI
<leader>do	Open DAP UI
<leader>dx	Close DAP UI
<leader>dt	Terminate debugging

---

Terminal

Key	Action
<F1>	Toggle terminal
<C-p>	Previous terminal buffer
<C-n>	Next terminal buffer

---

✏️ Completion (nvim-cmp)

Key	Action
<C-Space>	Trigger completion
<CR>	Confirm completion
<C-b>	Scroll docs up
<C-f>	Scroll docs down
<C-e>	Abort completion
<Down>	Next item
<Up>	Previous item

---

🌳 Code Structure (Aerial)

Key	Action
<C-a>	Toggle code outline

---

📝 Formatting

Key	Action
<D-f>	Format code (Neoformat)

Note: Neoformat auto-formats on save.

---

🖱️ Mouse

Action	Action
Click on Sign column	Open Telescope diagnostics

---

LSP Servers

Installed via Mason:

• eslint (ESLint)
• sourcekit (Swift)
• html (HTML)
• clangd (C/C++)
• ts_ls (TypeScript/JavaScript)
• pyright (Python)
• lua_ls (Lua)
• rust_analyzer (Rust)
• cssls (CSS)

Customization

Change Leader Key

Edit nvim/lua/config/keymaps.lua:

vim.g.mapleader = ","  -- Default is comma

Change Theme

Edit nvim/lua/chadrc.lua:

M.base46 = {
  theme = "onedark",  -- Change to other theme
}

---

Requirements

• Neovim ≥ 0.9
• macOS
• Git
• fd - Replace find for Telescope
• rg - Ripgrep for search
• fzf - Fuzzy finder

Install via Homebrew:

brew install neovim fd ripgrep fzf

---

Troubleshooting

# View logs
:nvim -l logs

# Sync plugins
:Lazy sync

# Check health
:checkhealth

---

Credits

Based on NvChad and plugins from the community.