Agentic.nvim provides a native chat interface for AI agents directly within Neovim, leveraging the Agent Client Protocol (ACP). It targets Neovim users seeking to integrate AI assistance without leaving their editor, offering seamless workflow continuity, session persistence, and rich context management by utilizing existing ACP provider configurations and authentication.

How It Works

This plugin acts as an interface to various AI agents (Claude, Gemini, Codex, etc.) by implementing the Agent Client Protocol (ACP). It directly uses the user's pre-configured ACP provider CLIs and authentication methods from their terminal, ensuring consistent performance and results. This approach avoids the need to reconfigure or manage separate API keys within Neovim, offering a unified experience for AI-assisted development.

Quick Start & Requirements

• Primary Install: Via a Neovim plugin manager (e.g., lazy.nvim configuration provided).
• Prerequisites:
  • Neovim v0.11.0 or higher.
  • ACP Provider CLIs must be installed manually by the user (e.g., claude-agent-acp, gemini-cli, codex-acp, opencode, cursor-agent, auggie, mistral-vibe). Installation instructions for various package managers are provided, but users should refer to official provider documentation.
  • For clipboard image pasting: img-clip.nvim dependency, which requires xclip/wl-clipboard (Linux) or pngpaste (macOS).
• Setup: Requires installing external ACP CLIs.

Highlighted Details

• Supports multiple ACP providers including Claude, Gemini, Codex, OpenCode, Cursor Agent, Auggie, and Mistral Vibe.
• Features zero-configuration authentication by leveraging existing terminal setups.
• Offers robust session persistence and restoration across Neovim restarts.
• Enables easy context control by adding files and text selections to conversations.
• Includes image and screenshot support directly within the chat interface.
• Provides an interactive permission system for AI tool calls.
• Allows multiple independent agent sessions per Neovim tab.
• Automatically includes system and project information in initial prompts for smarter context.
• Offers diff previews for AI-suggested file edits (side-by-side or inline).
• Integrates Neovim's native completion for ACP slash commands and workspace file referencing (@file).

Maintenance & Community

No specific details regarding maintainers, community channels (like Discord/Slack), or project health signals were found in the provided README.

Licensing & Compatibility

• License: MIT License.
• Compatibility: Permissive for modification and distribution, suitable for commercial use and integration with closed-source projects, provided acknowledgments are included.

Limitations & Caveats

The plugin requires manual installation of all ACP provider CLIs, as it does not manage these dependencies. Image pasting from the clipboard relies on external plugins and system utilities, which may have platform-specific limitations. A minimum Neovim version of 0.11.0 is mandatory.