An AI-powered assistant for Neovim that connects to services like Gemini and Amazon Q to help you understand and write code directly in your editor.

AskCode.nvim

AskCode is a Neovim plugin that helps developers explore and understand codebases by connecting to CLI-based AI assistants like gemini-cli and amazonq. It acts as your in-editor guide, letting you ask context-aware questions about selected code and receive answers without leaving Neovim.

✨ Features

• Multi-agent support: Choose your preferred AI backend (Gemini, AmazonQ, etc.).
• Configurable: Select agents and tweak settings via a simple Lua API.
• Prepared prompts: Built-in use cases like explaining code, finding bugs, or suggesting optimizations.
• Code replacement: Select code and ask AI to modify it directly in your buffer (add docstrings, fix bugs, refactor, etc.).
• Extensible: Add your own agents and custom prompts.
• Neovim-native UI: Responses are displayed in floating windows or splits, asynchronously and non-blockingly.

🚀 Getting Started

Prerequisites

• Neovim (v0.9.0 or later)
• A compatible AI assistant CLI installed and configured in your shell environment (e.g., gemini-cli, amazonq).

Installation

Install askCode.nvim using your favorite package manager.

Lazy.nvim

{
  "realEbi/askCode",
  config = function()
    require("askCode").setup({
      -- Your configuration here
    })
  end,
}

Packer.nvim

use {
  "realEbi/askCode",
  config = function()
    require("askCode").setup({
      -- Your configuration here
    })
  end,
}

Basic Configuration

By default, askCode.nvim uses gemini-cli. You can configure it to use a different agent or customize its behavior.

require("askCode").setup({
  agent = "gemini",        -- AI agent to use (default: "gemini")
  debug = false,           -- Enable debug mode (default: false)
  quit_key = "q",          -- Key to quit floating windows (default: "q")
  output_format = "json",  -- Output format (default: "