neovimcraft github

plugins configs about

pykeras/neovim

github github
neovim-configneovim-configuration
stars 48
issues 0
subscribers 1
forks 5
CREATED

UPDATED

Neovim Configuration Guide

If you are updating from previous versions, please make sure to run :Lazy sync and :Mason to update everything.

Update: Jul 6, 2026

  • Switching to Pyrefly instead Mypy
  • Minor bug fixes and tested with Neovim v0.12.4

Update: May 26, 2026 :sparkles:

  • New: <C>-p fuzzy file finder.
    • Searches all files under the Git project root, sorted by proximity to the currently open file.
  • Fix: neo-tree auto opening on focus

To enable copy/yank & paste over SSH using OSC52, add the following snippet to the end of your init.lua:

-- OSC52 clipboard integration for remote
-- Only enable when in a TTY session (e.g., SSH)
if vim.env.SSH_CONNECTION then
    local ok, osc52 = pcall(require, "vim.ui.clipboard.osc52")
    if ok then
        vim.g.clipboard = {
            name = "osc52",
            copy = {
                ["+"] = osc52.copy("+"),
                ["*"] = osc52.copy("*"),
            },
            paste = {
                ["+"] = osc52.paste("+"),
                ["*"] = osc52.paste("*"),
            },
        }
    end
end

Source discussion

⚠️ Note: Your terminal emulator must support OSC52 clipboard sequences.

This is a starter configuration for Neovim, featuring a curated selection of the most useful plugins for Python, Rust and JavaScript development. It's lightweight and highly customizable, suitable for both beginners and advanced users.

main environment

rust coding

A basic set of key mappings is included and located in lua/keymaps.lua. You can review and customize these mappings to align with your personal preferences.

Prerequisites

Before proceeding, ensure you meet the following requirements:

Neovim Version: v0.11.0 - v.11.3
Operating System: Rocky Linux 9.4, PopOS 22.04, Debian 12.9, Android with termux

Dependencies:

Ensure the following dependencies are installed for a seamless experience:

  • Ripgrep (for Telescope and fzf file search):

    sudo dnf install ripgrep

  • fzf (fuzzy finder binary required by the <C-p> file search):

    # Install via package manager (e.g., dnf)
sudo dnf install fzf

# Or install manually from https://github.com/junegunn/fzf

  • Python venv (for Python-based plugins):
    Replace <minor> with your Python minor version:

    sudo dnf install python3.<minor>-venv

  • Clipboard provider (e.g., xclip):

    sudo dnf install xclip

  • Node.js & npm (for LSP support via nvm):
    Install nvm from GitHub.

  • Prettier (for yaml,js,... formatting)

    npm install -g prettier

  • fd-find is also needed for python virtualenv selector:

    sudo dnf install fd-find

How to install:

$ cd ~/.config/nvim
$ git clone git@github.com:pykeras/neovim.git .
$ nvim

Useful Commands

  • Check Telescope health: 

    :checkhealth telescope

  • Save without formatting:

    :noautocmd write

  • Install formatters, debuggers, etc. (via Mason):

    :Mason

Key Bindings

Leader Key <leader>: The leader key is mapped to the spacebar ().

General

  • Which Key (Help Menu): Press <leader> to see available shortcuts.
  • Copy to clipboard: <leader>y
  • Paste from clipboard: <leader>p
  • Easier switching between splits:
    • Move to the left split: <C-h>
    • Move to the right split: <C-l>
    • Move to the upper split: <C-k>
    • Move to the lower split: <C-j>
  • Toggle relative line numbers: <leader>rl
  • Reload all open files: <leader>re
  • Clear search highlights: Esc
  • Escape insert mode: jj
  • Close all splits except current: <leader>qo

FZF File Finder (Proximity Search)

  • Open file in project (fuzzy, proximity-sorted): <C-p>
    • Scopes search to the Git root (nearest parent .git up to $HOME).
    • Displays files relative to the project root; common parent directories are stripped for a cleaner view.
    • Sorted by directory distance from the currently open file, then alphabetically.
    • Requires fzf binary and ripgrep.

Theme selection

The default theme is set to kanagawa-wave; feel free to change it.

  • Theme switcher menu: tsm
  • Next theme: tn
  • Previous theme: tp

Virtual Environment Selector (Python)

By default if you have .venv in project directory this setup will use that otherwise:

  • Open selector: <leader>vs
  • Select cached venv: <leader>vc

Debugging

For python make sure you run pip install debugpy in the virtualenv detected/selected.

  • Step into: <F2>
  • Step over: <F3>
  • Step out: <F4>
  • Continue/Start debugging: <F5>
  • Toggle breakpoint: <Leader>b
  • Set conditional breakpoint: <F6>
  • Terminate debugger: <F7>
  • Run last debugging session: <F8>

Flash (Navigation)

  • Flash jump (normal/visual/operator): s
  • Flash Treesitter jump (normal/visual/operator): S
  • Remote Flash (operator mode): r
  • Treesitter search (operator/visual mode): R
  • Toggle Flash search (command-line mode): <C-s>

Rustaceanvim

  • Show testable functions: <leader>rdt

Telescope

  • Search files: <leader>ff
  • Live grep files: <leader>fg
  • Show TODOs (Telescope): <leader>tt
  • Show TODOs (loclist): <leader>tl

NeoTree (File Explorer)

  • Open/Close NeoTree: <leader>e
  • Reveal file in NeoTree: <leader>E
  • NeoTree filesystem: <leader>nf
  • Git status NeoTree: <leader>gs

LSP Configuration

  • Hover documentation: K
  • Go to definition: gd
  • Go to definition (vertical split): <leader>gdv
  • Go to definition (horizontal split): <leader>gds
  • Peek definition: <leader>gdp
  • Code actions: <leader>ca
  • Show method signature (Insert mode): <C-k>
  • Copy diagnostic message to clipboard: <leader>cd

None-ls (Formatting)

  • File global formatting: <leader>gf

Bufferline (Tabs)

  • Select buffer: <leader>bs
  • Cycle next buffer: <Tab>
  • Cycle previous buffer: <S-Tab>
  • Move buffer left: 3bh move buffer left 3 times.
  • Move buffer right: 3bl move buffer right 5 times.
  • Close buffer: <leader>bx
  • Close all other buffers: <leader>bxa
  • Jump to buffer based on position number: <leader>num number can be 1 to 9

Commenting

  • Single line comment: ctrl+/
  • Multi-line comment (visual selection): ctrl+/

Git Integration

  • Preview hunk (change): <leader>gp
  • Git blame: <leader>gb
  • Git log (oneline graph, custom): <leader>gl
  • Git difference (file): <leader>gfd

Undo Tree

  • Open/Close undo tree: <leader>u

Session Management (Persisted)

  • Save session: <leader>ss
  • List sessions: <leader>sl
  • Delete session: <leader>sd

CodeSnap

  • Save to clipboard: <leader>cc
  • Save to ~/Pictures: <leader>cs

ToggleTerminal

  • Open/Close terminal: ctrl+\
  • Open terminal below: <leader>th
  • Open floating terminal: <leader>tf
  • Send current line to terminal (run command from docs): <leader>tst

UFO (Folding)

  • Fold all: zR
  • Unfold all: zM
  • Toggle fold under cursor: za

Spelling

  • Display suggestions: z=
  • Add word to dictionary: zg

Noice (Message Management)

  • Dismiss message: <leader>nd
  • List messages: <leader>nl

Tabular (CSV/TSV View)

  • View CSV as table: <leader>csv
  • View TSV as table: <leader>tsv

Optional Features

AI Integration (Avante)

  • Ensure LuaJIT is installed.
  • Rename ~/.config/nvim/lua/plugins/avante to avante.lua for Ollama.