Claude Code Neovim Plugin

A seamless integration between Claude Code AI assistant and Neovim

Features • Requirements • Installation • Configuration • Usage • Contributing • Discussions

This plugin was built entirely with Claude Code in a Neovim terminal, and then inside itself using Claude Code for everything!

Features

• 🚀 Toggle Claude Code in a terminal window with a single key press
• 🧠 Support for command-line arguments like --continue and custom variants
• 🔄 Automatically detect and reload files modified by Claude Code
• ⚡ Real-time buffer updates when files are changed externally
• 📱 Customizable window position and size (including floating windows)
• 🤖 Integration with which-key (if available)
• 📂 Automatically uses git project root as working directory (when available)
• 🧩 Modular and maintainable code structure
• 📋 Type annotations with LuaCATS for better IDE support
• ✅ Configuration validation to prevent errors
• 🧪 Testing framework for reliability (44 comprehensive tests)

Requirements

• Neovim 0.7.0 or later
• Claude Code CLI tool installed and available in your PATH
• plenary.nvim (dependency for git operations)

See CHANGELOG.md for version history and updates.

Installation

Using [lazy.nvim](https://github.com/folke/la...