Codecompanion.Nvim
AI coding assistant for Neovim with chat, inline transforms, and agent support
Essential for Neovim users who want AI assistance tied to their editor. Free, open-source, and supports a wide range of LLMs and agents via adapters. Its flexibility with custom prompts, rules files, and MCP integration sets it apart. However, it requires comfort with Neovim configuration and managing API keys. Beginners or non-Neovim users should look elsewhere.
- Neovim power users seeking AI coding assistance
- Developers who prefer terminal-based editors
- Users who want to integrate multiple LLMs and agents in one place
- Advanced users who need custom prompts and workflows
- Users who don't use Neovim or Vim
- Beginners unfamiliar with Vim keybindings and Lua configuration
- Users looking for a fully managed SaaS product with no API key management
We scan live Reddit threads, YouTube comments, X posts, G2 reviews and other communities — and hand you an honest verdict in under a minute.
- Honest verdict, not marketing
- Real pros & cons from real users
- Attributed quotes with receipts
3 free scans · no card needed
Skip CodeCompanion.nvim if you don't use Neovim, are not comfortable editing Lua config files, or want a turnkey AI coding assistant that works out of the box without managing API keys.
Most LLM providers require an API key with usage-based billing — your costs scale with each prompt and completion.
CodeCompanion is free and open-source, making it ideal for cost-conscious individuals or teams already paying for LLM API access. Cheaper than managed alternatives like GitHub Copilot ($10/mo) if you control your API usage, but you bear the API bills.
In short
Codecompanion.Nvim — AI coding assistant for Neovim with chat, inline transforms, and agent support. Best for Neovim power users seeking AI coding assistance, Developers who prefer terminal-based editors, Users who want to integrate multiple LLMs and agents in one place. Free to use.
Viability Score
How likely is Codecompanion.Nvim to still be operational in 12 months? Based on 4 signals — momentum (how recently it shipped), wrapper dependency, revenue model, and web presence.
Last calculated: July 2026
How we score →Key Features
- Chat buffer with LLMs
- Inline code transformations
- Agent Client Protocol (ACP) support
- Model Context Protocol (MCP) integration
- Custom prompts and slash commands
- Editor context to improve LLM output
- Rules files (CLAUDE.md, .cursor/rules, custom)
- Built-in prompt library (LSP errors, code explanations)
- Multiple simultaneous chat buffers
- Vision and image input support
- Async execution for fast performance
- Community-contributed and user-created adapters
- Workflows and tools for automation
- Events and UI extensions
About Codecompanion.Nvim
CodeCompanion.nvim is an open-source Neovim plugin that integrates large language models and coding agents directly into your editor. It offers multiple interaction modes: a chat buffer for conversational AI, inline transformations for code creation and refactoring, and support for the Agent Client Protocol (ACP) to run agents like Claude Code, Cline CLI, and Gemini CLI within Neovim. You can connect to LLM providers including Anthropic, DeepSeek, Google Gemini, GitHub Copilot, Mistral, Ollama, OpenAI, OpenRouter, xAI, and many more, or add your own. The plugin supports Model Context Protocol (MCP) for extended capabilities, editor context to improve LLM output, slash commands, custom prompts, rules files (CLAUDE.md, .cursor/rules), a built-in prompt library, vision/image inputs, and multiple simultaneous chat buffers. Designed for Neovim power users, it requires you to bring your own API keys for most providers but is free and deeply customizable. It is ideal for developers who want a flexible, Vim-native AI coding assistant without leaving the terminal. Unlike closed-source AI editors or plugins that lock you into a single provider, CodeCompanion.nvim gives you full control over your LLM provider, agent choice, and workflow automation through Lua configuration, slash commands, and custom prompts. It's the most extensible AI coding tool for Neovim, comparable to Copilot Chat but open and multi-model.
Behind the Verdict
Pick CodeCompanion.nvim if you live in Neovim and want an AI assistant that respects your terminal-based workflow. The chat buffer feels natural to Vim users, and inline transformations make refactoring fast. We'd reach for this when we need to switch between providers—Ollama for local models, Claude for tricky codegen, GPT-4 for brainstorming—all without leaving the editor. The ACP support is a standout: running Claude Code or Cline CLI as a chat agent inside Neovim beats toggling between terminals. Pass on this if you're not willing to configure Neovim or manage API keys. It's not plug-and-play; you'll need to set up adapters, rules files, and custom prompts to get the most out of it. Beginners often struggle with the initial setup. Also, if you want a single-provider, polished experience without fiddling, something like GitHub Copilot in VS Code might suit you better. Compared to Copilot Chat (which only works with GitHub Copilot), CodeCompanion.nvim supports many LLMs and agents. Compared to avante.nvim, it has broader adapter coverage and native ACP support. The biggest caveat: performance depends on your LLM provider's latency and rate limits—there's no built-in model hosting. In practice, the async execution keeps the editor responsive even with large prompts. The built-in prompt library is handy for quick LSP explanation or test generation. But the real power is in custom workflows—tying slash commands to specific prompts and rules. If you invest time in configuring it, CodeCompanion can be faster than any GUI tool.
Researching Codecompanion.Nvim? Get your full AI stack in 60 seconds.
Free, no signup — tell us your goal and get tools matched to your budget & existing stack.
Real-world workflow fit
Concrete scenarios for the personas Codecompanion.Nvim actually fits — and what changes day-one when you adopt it.
You select a function in your buffer, trigger inline transformation, and ask the AI to refactor it for readability. The plugin uses your configured adapter (e.g., GPT-4) to rewrite the code directly in the buffer.
Outcome: The code is refactored in seconds without leaving Neovim, saving time on manual edits.
You open a chat buffer, paste the diff, and ask for potential bugs or improvements. The AI analyzes the code using editor context and rules files, providing actionable feedback.
Outcome: You get a second opinion on code quality, helping catch issues before merging.
Use Cases
- Refactor code inline with AI suggestions directly in your buffer.
- Chat with an AI about code issues using multiple conversation buffers.
- Create custom slash commands to automate repetitive coding tasks.
- Integrate with MCP tools to extend AI capabilities with external data.
- Leverage agent protocols to run Claude Code or Cline CLI within Neovim.
- Use rules files like CLAUDE.md to guide AI behavior across projects.
Models Under the Hood
as of 2026-07-15
Limitations
- CodeCompanion.nvim is a Neovim plugin, so it is limited to the Neovim editor ecosystem.
- Users must provide their own API keys for most LLM providers, which may incur costs.
- The plugin does not have built-in rate limiting or context window management; it depends on the underlying model's capabilities.
as of 2026-07-05
12-month cost
Project the real annual outlay, including the implied monthly cost when only an annual tier is published.
Vendor list price only. Add-on usage, seat overages, and contract minimums are surfaced under Hidden costs & gotchas.
Plans compared
For each published Codecompanion.Nvim tier: who it actually fits, and what it adds vs. the previous tier. Cross-reference the cost calculator above for projected annual outlay.
Free
$0/mo
Ideal for
Any Neovim user who wants a free, open-source AI coding assistant and already has API keys for LLMs.
What this tier adds
Free entry point with all features — no paid tiers; you bring your own API keys.
Where the pricing makes sense
The company stage and team size where Codecompanion.Nvim's pricing actually pencils out — and where peers do it cheaper.
CodeCompanion is free and open-source, making it ideal for cost-conscious individuals or teams already paying for LLM API access. Cheaper than managed alternatives like GitHub Copilot ($10/mo) if you control your API usage, but you bear the API bills.
Setup time & first value
How long it actually takes to get something useful out of Codecompanion.Nvim — broken out by persona, not the marketing-page minute.
For a user comfortable with Neovim: 10-15 minutes to install via lazy.nvim or packer, configure an adapter (e.g., OpenAI), and test a chat. For a new user learning Neovim config: 30-60 minutes plus learning curve.
Switching to or from Codecompanion.Nvim
How to bring data in from common predecessors and how to get it back out — written for the switcher, not the buyer.
- →From Copilot.vim: Install CodeCompanion and configure your adapter — both can coexist, but you may replace Copilot chat with CodeCompanion's chat buffer.
- →From other Neovim AI plugins (e.g., avante.nvim): Similar configuration approach; migrate custom prompts and adapters manually.
- ↗To a managed IDE plugin (e.g., GitHub Copilot in VS Code): Export your custom prompts and rules files manually.
- ↗To a standalone CLI agent (e.g., Claude Code CLI): No migration path; you'll lose Neovim integration.
Integrations
Resources & Guides
Official links
Tools that pair well with Codecompanion.Nvim
Common stack mates teams adopt alongside Codecompanion.Nvim, with the specific reason each pairing earns its keep.
Featured Head-to-Head Comparisons
Alternatives to Codecompanion.Nvim
View allFrequently Asked Questions
Categories
Best-of guides
Used Codecompanion.Nvim? Help shape our editorial sentiment research.