Neovim Gemini

v1.0.0Developer Toolsstable

A Neovim plugin to integrate Gemini CLI well (+ Qwen-code now)

gemini-cliide-integrationluamcp-servernvim
Share:
82
Stars
0
Downloads
0
Weekly
0/5

What is Neovim Gemini?

Neovim Gemini is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to neovim plugin to integrate gemini cli well (+ qwen-code now)

A Neovim plugin to integrate Gemini CLI well (+ Qwen-code now)

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A Neovim plugin to integrate Gemini CLI well (+ Qwen-code no

Use Cases

Integrate Gemini CLI with Neovim editor.
Enable Qwen-code support in Neovim.
Use AI assistance directly in vim workflows.
gutsavgupta

Maintainer

LicenseMIT
Languagelua
Versionv1.0.0
UpdatedMay 16, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx nvim-gemini-companion

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Neovim Gemini

nvim-gemini-companion is a Neovim plugin that embeds Google Gemini CLI and QwenLM Qwen-code directly into your editor workflow through a persistent sidebar and terminal sessions. It lets you send selected code, buffer content, or LSP diagnostics to an AI agent and receive diffs you can accept or reject without leaving Neovim. Developers use it to get in-editor AI code assistance from Gemini or Qwen-code while keeping their existing keybindings and LSP setup intact.

Prerequisites

  • Neovim 0.9 or later
  • nvim-lua/plenary.nvim plugin installed
  • gemini-cli (Google Gemini) and/or qwen-code (QwenLM) installed and available in PATH
  • A Neovim plugin manager such as lazy.nvim or packer.nvim
  • An MCP client is not required — the plugin communicates directly with the CLI tools
1

Install gemini-cli and/or qwen-code

At least one of these CLI tools must be installed and accessible from your shell PATH before the plugin will function. Follow the official installation instructions for each tool you want to use.

# Verify tools are in PATH after installing them
which gemini
which qwen-code
2

Add the plugin to your Neovim config

Add nvim-gemini-companion to your plugin manager. The example below uses lazy.nvim. Adjust the cmds list to include only the agents you have installed.

{
  "gutsavgupta/nvim-gemini-companion",
  dependencies = { "nvim-lua/plenary.nvim" },
  event = "VeryLazy",
  config = function()
    require("gemini").setup({
      cmds = { "gemini", "qwen" },
      win = {
        preset = "right-fixed",
        width = 0.35,
      },
    })
  end,
}
3

Install plugins and restart Neovim

Run your plugin manager's install command (e.g., :Lazy sync in lazy.nvim), then restart Neovim to load the plugin.

4

Open the AI sidebar

Use the :GeminiToggle command to open or close the companion sidebar. The sidebar hosts the terminal session with your chosen AI CLI.

:GeminiToggle
5

Send code or diagnostics to the AI

In visual mode, select a code block and run :GeminiSend to send it to the AI. To forward LSP diagnostics, use :GeminiSendLineDiagnostic for the current line or :GeminiSendFileDiagnostic for the whole file.

:GeminiSend
:GeminiSendFileDiagnostic
6

Switch between Gemini and Qwen-code

If both agents are configured, use the terminal switching keybindings Alt+] and Alt+[ to cycle between active AI sessions.

Neovim Gemini Examples

Client configuration

This plugin is configured entirely inside Neovim's Lua config and does not use an MCP client JSON config. Add this to your init.lua or lazy.nvim spec.

require("gemini").setup({
  cmds = { "gemini", "qwen" },
  win = {
    preset = "right-fixed",
    width = 0.35,
    height = 0.8,
  },
})

Prompts to try

After opening the sidebar, type these prompts directly in the AI terminal session or send selected code with :GeminiSend.

- "Explain what this selected function does and suggest improvements."
- "Here are my LSP errors — how do I fix them?"
- "Refactor this code to use async/await instead of callbacks."
- "Write unit tests for the selected module."

Troubleshooting Neovim Gemini

':GeminiToggle' reports 'gemini command not found'

Make sure gemini-cli is installed and its binary directory is in your shell PATH. Start Neovim from a terminal where 'which gemini' returns a valid path.

Plugin loads but no sidebar appears

Confirm plenary.nvim is installed and loaded before nvim-gemini-companion. Run ':checkhealth' to verify dependencies, and check that the plugin's event trigger ('VeryLazy') has fired.

:GeminiSend has no effect when called in visual mode

Ensure you enter visual mode (v or V), select text, and then run :GeminiSend. The command must be called while a visual selection is active and the sidebar session must already be started with :GeminiSwitchToCli.

Frequently Asked Questions about Neovim Gemini

What is Neovim Gemini?

Neovim Gemini is a Model Context Protocol (MCP) server that neovim plugin to integrate gemini cli well (+ qwen-code now) It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Neovim Gemini?

Follow the installation instructions on the Neovim Gemini GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Neovim Gemini?

Neovim Gemini works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Neovim Gemini free to use?

Yes, Neovim Gemini is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "nvim-gemini-companion": { "command": "npx", "args": ["-y", "nvim-gemini-companion"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Neovim Gemini?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides