KabirNvim 🚀

A Modern Neovim Distribution with VS Code-style Keybindings

KabirNvim is a complete, user-friendly Neovim distribution that works out of the box with minimal configuration. It provides a modern IDE experience with VS Code-style keybindings, dual AI assistant support, and a beautiful transparent UI.

✨ What Makes KabirNvim Different

• 🚀 Zero Configuration: Works perfectly out of the box
• 🎯 VS Code Keybindings: Familiar shortcuts for easy transition
• 🤖 Dual AI Support: Seamlessly switch between Copilot and Codeium
• 🎨 Beautiful UI: Gruvbox theme with transparency support
• ⚡ Performance First: Optimized lazy loading and fast startup
• 🔧 Easy Customization: Simple configuration without complex setups

🚀 Quick Installation

One-Line Install

bash <(curl -s https://raw.githubusercontent.com/kabirajpan/kabirnvim/main/install.sh)

Manual Installation

# 1. Backup existing config
mv ~/.config/nvim ~/.config/nvim.backup

# 2. Clone KabirNvim
git clone https://github.com/kabirajpan/kabirnvim ~/.config/nvim

# 3. Start Neovim
nvim

That's it! KabirNvim will automatically:

• Install all plugins
• Set up language servers
• Configure everything for you

🎮 Getting Started

Essential Commands

Command	Description
:KabirNvimConfig	Open configuration file
:KabirNvimInfo	Show current settings
:KabirNvimUpdate	Update all plugins
:KabirNvimReload	Reload configuration

AI Assistants

Key	Action
F8	Enable GitHub Copilot
F9	Enable Codeium
F10	Toggle between assistants

Key Features

• File Explorer: Ctrl+E to toggle
• Find Files: Ctrl+P for file search
• Global Search: Ctrl+Shift+F to search in all files
• Command Palette: Ctrl+Shift+P for commands

⚙️ Configuration

KabirNvim uses a simple configuration approach. You only need to edit one file:

Quick Configuration

:KabirNvimConfig

Manual Configuration

nvim ~/.config/nvim/lua/user/config.lua

Configuration Options

-- ~/.config/nvim/lua/user/config.lua
return {
  -- Theme settings
  theme = {
    name = "gruvbox",        -- gruvbox, tokyonight, catppuccin
    transparent = true,       -- Enable transparency
    style = "dark",          -- dark, light
  },
  
  -- AI assistants
  ai = {
    copilot = true,          -- Enable GitHub Copilot
    codeium = true,          -- Enable Codeium
    default = "copilot",     -- Default AI assistant
  },
  
  -- Editor behavior
  editor = {
    number = true,           -- Show line numbers
    relative_number = false, -- Use relative line numbers
    wrap = false,            -- Wrap long lines
    indent_size = 2,         -- Indentation size
    auto_save = false,       -- Auto-save on change
  },
  
  -- Key binding style
  keymaps = {
    style = "vscode",        -- vscode, vim, custom
  },
  
  -- UI components
  ui = {
    dashboard = true,        -- Show dashboard on startup
    bufferline = true,       -- Show buffer tabs
    statusline = true,       -- Show status line
    file_explorer = "nvimtree", -- nvimtree, neotree, none
  },
}

🎯 Key Bindings

File Operations

Key	Action
Ctrl+S	Save file
Ctrl+N	New file
Ctrl+W	Close buffer
Ctrl+E	Toggle file explorer
Ctrl+P	Find files

Editing

Key	Action
Ctrl+C/X/V	Copy/Cut/Paste
Ctrl+Z/Y	Undo/Redo
Ctrl+A	Select all
Ctrl+/	Toggle comment
Alt+Up/Down	Move line up/down

Navigation

Key	Action
Alt+Left/Right	Switch buffers
Ctrl+B	Buffer list
F12 / gd	Go to definition
Shift+F12	Find references

Search & Replace

Key	Action
Ctrl+F	Find in file
Ctrl+H	Replace in file
Ctrl+Shift+F	Global search

🔌 Adding Custom Plugins

Edit ~/.config/nvim/lua/user/plugins.lua:

return {
  -- Add new plugin
  {
    "your-username/plugin-name",
    config = function()
      -- Plugin configuration
    end,
  },
  
  -- Override built-in plugin
  {
    "nvim-telescope/telescope.nvim",
    opts = {
      -- Custom telescope options
    },
  },
}

🛠️ Language Support

KabirNvim automatically detects and installs language servers for:

• Web Development: TypeScript, JavaScript, HTML, CSS, Tailwind
• Systems: Rust, C/C++, Go
• Scripting: Python, Lua, Bash
• Data: JSON, YAML, TOML, XML
• Others: Java, SQL, Markdown

🎨 Themes

Switch themes easily:

:KabirNvimTheme tokyonight
:KabirNvimTheme catppuccin
:KabirNvimTheme gruvbox

Or use the theme picker:

:KabirNvimTheme

🔄 Updates

Keep your distribution up to date:

:KabirNvimUpdate

🆚 Comparison

Feature	KabirNvim	AstroNvim	NvChad
Setup Complexity	⭐⭐⭐⭐⭐	⭐⭐⭐	⭐⭐⭐
VS Code Keybindings	✅ Built-in	❌ Manual	❌ Manual
Dual AI Support	✅ F8/F9/F10	❌ Manual	❌ Manual
One-File Config	✅ user/config.lua	❌ Multiple files	❌ Multiple files
Transparency	✅ Built-in	⚙️ Manual setup	⚙️ Manual setup
Beginner Friendly	✅ Zero config	⚙️ Learning curve	⚙️ Learning curve

📁 Directory Structure

~/.config/nvim/
├── init.lua              # Main entry point (don't edit)
├── lua/
│   ├── kabirnvim/        # Distribution core (don't edit)
│   └── user/             # Your customizations
│       ├── config.lua    # Main configuration file
│       └── plugins.lua   # Custom plugins
└── README.md

You only need to edit files in the lua/user/ directory!

🐛 Troubleshooting

Common Issues

1. Plugins not loading

   :Lazy sync

2. Language servers not working

   :Mason

3. AI assistants not working

   • Copilot: :Copilot auth
   • Codeium: :Codeium Auth

4. Reset to defaults

   rm ~/.config/nvim/lua/user/config.lua
   nvim  # Will recreate with defaults

Debug Commands

• :KabirNvimInfo - Show current configuration
• :checkhealth - Check Neovim health
• :Lazy - Manage plugins
• :Mason - Manage language servers

📄 Requirements

• Neovim >= 0.8.0
• Git (for plugin management)
• Node.js (optional, for JS/TS language servers)
• Python (optional, for Python development)
• Nerd Font (recommended for icons)

Optional Dependencies

• ripgrep - for faster searching
• fd - for faster file finding
• LazyGit - for advanced git integration

📄 License

MIT License - See LICENSE file for details.

🌟 Contributing

Found a bug or want to suggest a feature? Please:

1. Check existing issues first
2. Create a detailed issue or PR
3. Help make KabirNvim even better!

💝 Support

Love KabirNvim? Star the repo and share with friends!

---

Happy coding with KabirNvim! 🚀