codecompanion.nvim

A Neovim AI coding assistant for coding with LLMs (Anthropic, OpenAI, Gemini, Copilot and more) and AI agents. With built-in support for Agent Client Protocol (ACP), Model Context Protocol (MCP), and agents like Claude Code and Codex

New features are always announced here

:purple_heart: Sponsors

Thank you to the following people:

If you love CodeCompanion and use it in your workflow, please consider sponsoring me

:sparkles: Features

• :speech_balloon: Copilot Chat meets Zed AI, in Neovim
• :zap: Integrates Neovim with LLMs and Agents in the CLI
• :electric_plug: Support for LLMs from Anthropic, DeepSeek, Google Gemini, GitHub Copilot, GitHub Models, Mistral, Novita, Ollama, OpenAI, Azure OpenAI, OpenRouter, HuggingFace and xAI out of the box (or bring your own)
• :robot: Support for Agent Client Protocol, enabling coding with agents like Augment Code, Cagent from Docker, Claude Code, Codex, Copilot CLI, Gemini CLI, Goose, Cursor CLI, Kimi CLI, Kiro, Mistral Vibe and OpenCode
• :heart_hands: User contributed and supported adapters
• :battery: Support for Model Context Protocol (MCP)
• :rocket: Inline transformations, code creation and refactoring
• :art: Editor Context, Slash Commands, Agents/Tools and Workflows to improve LLM output
• :brain: Support for rules files like CLAUDE.md, .cursor/rules and your own custom ones
• :sparkles: Built-in prompt library for common tasks like advice on LSP errors and code explanations
• :building_construction: Create your own custom prompts, Editor Context and Slash Commands
• :books: Have multiple chats open at the same time
• :art: Support for vision and images as input
• :muscle: Async execution for fast performance

:camera_flash: In Action

:rocket: Getting Started

Everything you need to know about CodeCompanion (installation, configuration and usage) is within the docs.

:toolbox: Troubleshooting

Before raising an issue, there are a number of steps you can take to troubleshoot a problem:

Checkhealth

Run :checkhealth codecompanion and check all dependencies are installed correctly. Also take note of the log file path.

Turn on logging

Update your config and turn debug logging on:

-- lazy.nvim
{
  "olimorris/codecompanion.nvim",
  dependencies = {
    "nvim-lua/plenary.nvim",
    "nvim-treesitter/nvim-treesitter",
  },
  opts = {
    -- NOTE: The log_level is in `opts.opts`
    opts = {
      log_level = "DEBUG", -- or "TRACE"
    },
  },
},

-- Other package managers
require("codecompanion").setup({
  opts = {
    log_level = "DEBUG", -- or "TRACE"
  }
})

and inspect the log file as per the location from the checkhealth command.

Try with a minimal.lua file

A large proportion of issues which are raised in Neovim plugins are to do with a user's own config. That's why I always ask users to fill in a minimal.lua file when they raise an issue. We can rule out their config being an issue and it allows me to recreate the problem.

For this purpose, I have included a minimal.lua file in the repository for you to test out if you're facing issues. Simply copy the file, edit it and run neovim with nvim --clean -u minimal.lua.

:gift: Contributing

I am open to contributions but they will be implemented at my discretion. Feel free to open up a discussion before embarking on a PR and please read the CONTRIBUTING.md guide.

:clap: Acknowledgements

• Steven Arcangeli for his genius creation of the chat buffer and his feedback early on
• Wtf.nvim for the LSP assistant action
• CopilotChat.nvim for the rendering and usability of the chat buffer
• Aerial.nvim for the Tree-sitter parsing which inspired the symbols Slash Command
• Saghen for the fantastic docs inspiration from blink.cmp and continued PRs to the project
• Catwell for the queue inspiration that I use to stack agents and tools
• bassamsdata for the amazing insert_edit_into_file tool (the list is endless) and ongoing contributions to this project
• ravitemer for the fantastic extensions API
• Davidyz for his continued, excellent contributions that keep CodeCompanion going
• Conrad Irwin, Agus Zubiaga and Morgan Krey from Zed Industries for their support in implementing ACP
• Sidekick.nvim for the diff and terminal input inspiration