Skip to content

About

Neovim config on Linux/MacOS/Windows/WSL2.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

207 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Introduction

This project is a modern, batteries-included Neovim configuration built with lazy.nvim. It aims to provide a full-featured coding environment out of the box:

  • Editor UX — fuzzy finding (fzf-lua), file explorer (nvim-tree), enhanced motions (flash.nvim, nvim-spider), keybinding discovery (which-key.nvim), buffer/tabline, and a polished statusline.
  • LSP & completion — Mason-managed language servers, lspsaga.nvim workflows, incremental symbol renaming, and fast blink.cmp completion, all wired into treesitter text objects.
  • AI coding agent — first-class integration with the Oh My Pi coding agent via pi-nvim.
  • Git & code quality — gitsigns, gitlinker, diffview-plus, grug-far, conform.nvim, and TODO comment highlighting.
  • Looks & feel — Everforest colorscheme, nerdfont icons, and a curated set of keybindings documented below.

Note: opencode and deepseek-harness integrations are deprecated (struck through below); Oh My Pi is the active AI-agent backend.

Requirements

Recommanded

Install

curl -fsSL https://raw.githubusercontent.com/gvcgo/neovim_conf/refs/heads/main/install.sh | bash

Pre-Install

bun install -g @oh-my-pi/pi-coding-agent

Oh My Pi Profile

Set OMP_PROFILE before starting Neovim to open Oh My Pi with a specific profile:

export OMP_PROFILE=your-profile
nvim

When OMP_PROFILE is set, the Oh My Pi integration runs omp --profile your-profile. If it is unset, it runs omp without a profile.

Post-Install(tree-sitter plugins needed by this project)

:TSInstall lua rust javascript go markdown bash zsh cpp json typescript yaml proto

Terminal Proxy

# fix opencode connection for opencode.nvim when a proxy has been set for terminal
alias OnProxy="export http_proxy=http://127.0.0.1:2023;export https_proxy=http://127.0.0.1:2023;export no_proxy=127.0.0.1,localhost,::1"
alias OffProxy="unset http_proxy;unset https_proxy"

Key Mappings

  • leader = " "
keys desc lua file
<F5> (normal) restart Neovim and reload all config init.lua
<leader>wh (normal) move to window left core/keymap.lua
<leader>wj (normal) move to window below core/keymap.lua
<leader>wk (normal) move to window above core/keymap.lua
<leader>wl (normal) move to window right core/keymap.lua
<leader>ww (normal) cycle to next window core/keymap.lua
<leader>ws (normal) split window horizontally core/keymap.lua
<leader>wv (normal) split window vertically core/keymap.lua
<leader>wq (normal) close current window core/keymap.lua
jk (insert) Esc core/keymap.lua
q (visual) Exit visual mode core/keymap.lua
<CR> (insert) Accept Blink completion or fallback plugins/blink.lua
gl (normal/visual) goto line end core/keymap.lua
gh (normal/visual) goto line start core/keymap.lua
gj (normal) goto screen bottom core/keymap.lua
gk (normal) goto screen top core/keymap.lua
ge (normal/visual) goto last line core/keymap.lua
gp (normal) goto previous buffer plugins/bufferline.lua
gn (normal) goto next buffer plugins/bufferline.lua
gm (normal) goto specified buffer plugins/bufferline.lua
<leader>y (normal/visual) copy to clipboard core/keymap.lua
<C-a> (normal) select all core/keymap.lua
<C-s> (normal) write core/keymap.lua
<C-j> (terminal) Terminal normal mode core/keymap.lua
<C-x> (normal) close current buffer plugins/bufferline.lua
<A-j> (normal) move current line down plugins/move.lua
<A-k> (normal) move current line up plugins/move.lua
<A-h> (normal) move current word left plugins/move.lua
<A-l> (normal) move current word right plugins/move.lua
<A-j> (visual) move selected block down plugins/move.lua
<A-k> (visual) move selected block up plugins/move.lua
<A-h> (visual) move selected block left plugins/move.lua
<A-l> (visual) move selected block right plugins/move.lua
<leader>. (normal/visual/terminal) Toggle Oh My Pi plugins/pi-nvim.lua
<C-S-o> (normal/visual) Jump to OMP terminal plugins/pi-nvim.lua
<C-S-o> (terminal) Jump to editor buffer plugins/pi-nvim.lua
<leader>aa (normal/visual) Pi: Open dialog plugins/pi-nvim.lua
<leader>af (normal) Pi: Send file plugins/pi-nvim.lua
<leader>as (visual) Pi: Send selection plugins/pi-nvim.lua
<leader>ab (normal) Pi: Send buffer plugins/pi-nvim.lua
<leader>ao (normal) Pi: List sessions plugins/pi-nvim.lua
<leader>f (normal) find files plugins/fzf.lua
<leader>t (normal) Search TODOs in current buffer plugins/fzf.lua
<leader>T (normal) Search TODO comments in project plugins/fzf.lua
<leader>C (normal) find nvim config files plugins/fzf.lua
<leader>d (normal) Search Diagnostics plugins/fzf.lua
<leader>k (normal) Search keymaps plugins/fzf.lua
<leader>S (normal) Search workspace symbols plugins/fzf.lua
<leader>s (normal) Search document symbols plugins/fzf.lua
<leader>/ (normal) Search string plugins/fzf.lua
<leader>L (normal) restart lsp core/keymap.lua
K (normal) Lspsaga: Hover Documentation plugins/lspsaga.lua
gr (normal) Lspsaga: LSP Finder plugins/lspsaga.lua
gi (normal) Lspsaga: LSP Finder plugins/lspsaga.lua
gs (normal) Lspsaga: Peek Definition plugins/lspsaga.lua
gd (normal) Lspsaga: Goto Definition plugins/lspsaga.lua
<leader>r (normal) Rename Symbol plugins/inc-rename.lua
<leader>c (normal/visual) Lspsaga: Code Action plugins/lspsaga.lua
<leader>o (normal) Lspsaga: Toggle Outline plugins/lspsaga.lua
<leader>v (normal/terminal) Lspsaga: Toggle Terminal plugins/lspsaga.lua
<C-d> (Lspsaga preview) Scroll preview down plugins/lspsaga.lua
q (Lspsaga rename UI) quit rename UI plugins/lspsaga.lua
<C-u> (Lspsaga preview) Scroll preview up plugins/lspsaga.lua
<leader>e (normal) toggle nvim-tree plugins/nvim-tree.lua
<leader>R (normal) replace in workspace plugins/grug-far.lua
w (normal/operator/visual) spider motion w plugins/spider.lua
e (normal/operator/visual) spider motion e plugins/spider.lua
b (normal/operator/visual) spider motion b plugins/spider.lua
<leader>? (normal) Buffer Local Keymaps (which-key) plugins/which-key.lua
s (normal/visual/operator) Flash plugins/flash.lua
S (normal/visual/operator) Flash Treesitter plugins/flash.lua
<C-s> (command) Toggle Flash Search plugins/flash.lua
]f (normal/visual/operator) goto next function start plugins/treesitter-textobjects.lua
]c (normal/visual/operator) goto next class start plugins/treesitter-textobjects.lua
]t (normal/visual/operator) goto next class end plugins/treesitter-textobjects.lua
]m (normal/visual/operator) goto next function end plugins/treesitter-textobjects.lua
[f (normal/visual/operator) goto previous function start plugins/treesitter-textobjects.lua
[c (normal/visual/operator) goto previous class start plugins/treesitter-textobjects.lua
[t (normal/visual/operator) goto previous class end plugins/treesitter-textobjects.lua
[m (normal/visual/operator) goto previous function end plugins/treesitter-textobjects.lua
<leader>gb (normal/visual) Open git blame link plugins/gitlinker.lua
<leader>gg (normal/visual) Open git link plugins/gitlinker.lua
<leader>gc (normal) Search git commit log plugins/fzf.lua
<leader>gr (normal) Search git reflog plugins/fzf.lua
<leader>gd (normal) Diffview: Compare working tree with index (uncommitted changes and untracked files) plugins/diff-view.lua
q (Diffview view/file panel) Close the diff view plugins/diff-view.lua
<leader>h (Diffview view/file panel) Focus left diff view plugins/diff-view.lua
<leader>l (Diffview view/file panel) Focus right diff view plugins/diff-view.lua
]e (Diffview view) Jump to next change block (hunk) plugins/diff-view.lua
[e (Diffview view) Jump to previous change block (hunk) plugins/diff-view.lua
]f (Diffview view/file panel) Jump to next file plugins/diff-view.lua
[f (Diffview view/file panel) Jump to previous file plugins/diff-view.lua
do (Diffview view) Get changes from the other side plugins/diff-view.lua
dp (Diffview view) Push changes to the other side plugins/diff-view.lua
t (Diffview view) Toggle layout plugins/diff-view.lua
gc (Diffview view) Toggle fold (compact mode) plugins/diff-view.lua
gf (Diffview view/file panel) Open file in previous tab and close diffview plugins/diff-view.lua
g? (Diffview view) Show keybinding help plugins/diff-view.lua
- (Diffview file panel) Stage/unstage the current file plugins/diff-view.lua
]e (normal) Next Git hunk plugins/git.lua
[e (normal) Previous Git hunk plugins/git.lua

tree-sitter textobjects

keys desc lua file
af (visual/operator) select function outer plugins/treesitter-textobjects.lua
if (visual/operator) select function inner plugins/treesitter-textobjects.lua
ac (visual/operator) select class outer plugins/treesitter-textobjects.lua
ic (visual/operator) select class inner plugins/treesitter-textobjects.lua
aa (visual/operator) select parameter outer plugins/treesitter-textobjects.lua
ia (visual/operator) select parameter inner plugins/treesitter-textobjects.lua
as (visual/operator) select local scope plugins/treesitter-textobjects.lua
ii (visual/operator) select subword inner plugins/textobjs.lua
ai (visual/operator) select subword outer plugins/textobjs.lua
r (operator) Remote Flash plugins/flash.lua
R (operator/visual) Treesitter Search plugins/flash.lua

gallery

neovim fzf outline

references

Neovim Plugins

Neovim Dependencies

Other References

About

Neovim config on Linux/MacOS/Windows/WSL2.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages