hrsh7th/nvim-cmp
Nvim Cmp
This project is a Lua-based completion engine for Neovim that aggregates real-time text suggestions from multiple data sources into a single interface. It functions as a modular framework for extending the editor with custom completion logic, acting as both a fuzzy text suggestion tool and an interface for the Language Server Protocol.
The engine utilizes a source-agnostic provider interface to standardize how disparate data sources feed candidates into a central logic engine. It employs asynchronous candidate fetching and a non-blocking architecture to retrieve suggestions from external servers and filesystems without freezing the editor interface.
The capability surface covers a wide range of specialized completions, including language server symbols, filesystem paths, buffer text, and git metadata. It also provides integration for large language models for AI-assisted coding, as well as specialized suggestions for CSS styling, academic references, and symbol insertion.
The system includes a dynamic menu for rendering results and a keymap management system for navigating and confirming suggestions.
Features
- Completion Frameworks - Acts as a modular framework for extending Neovim with custom Lua-based completion logic and external data providers.
- In-Editor Text Completion - Provides real-time suggestions for code and text while typing in Neovim to reduce keystrokes and errors.
- LSP Integration - Provides deep integration with the Language Server Protocol to offer intelligent symbol completions and signature help.
- Asynchronous Data Fetching - Uses non-blocking threads to fetch completion candidates from external servers and filesystems without freezing the editor.
- Provider Abstraction Layers - Standardizes how disparate data sources feed completion candidates into the central engine via a common Lua API.
- Completion Provider Integrations - Implements a modular interface to integrate multiple completion providers for snippets, paths, and symbols.
- Fuzzy Search Engines - Filters completion candidates from buffers, filesystem paths, and external registries using a fuzzy search engine.
- Completion Engines - Implements a comprehensive Lua-based completion engine that aggregates suggestions from multiple sources into a single interface.
- Language Server Integrations - Interfaces with Language Server Protocol servers to provide intelligent code completion and signature help.
- LSP Clients - Connects Neovim to Language Server Protocol servers for intelligent symbols, signatures, and type-aware completions.
- Lua-Based Plugin Architectures - Uses a Lua-based logic engine for filtering and sorting completion candidates within the Neovim runtime.
- AI Coding Assistants - Integrates large language models into the editor to provide intelligent, context-aware code suggestions.
- Context-Aware Text Editing - Scans the active document buffer to extract words and symbols for local text suggestions.
- Custom Completion Providers - Allows customizing how completions are filtered, triggered, and displayed using custom logic functions.
- Completion Keymaps - Provides a dedicated keymap management system for navigating, selecting, and confirming suggestions from the completion list.
- Fuzzy Search Interfaces - Implements a fuzzy-matching interface for locating completion candidates across buffers, files, and external results.
- Workflow Customization - Provides configuration options to match completion triggers and filtering to a developer's specific coding habits.
- File Path Autocompletion - Suggests valid filesystem paths and folder names asynchronously to prevent editor freezing.
- Floating Completion Menus - Renders a real-time floating menu of filtered suggestions based on the current cursor position.
- Keymap Action Dispatchers - Maps specific keystrokes to internal functions for navigating and confirming suggestions in the completion list.
- Completion - Primary completion engine for Neovim.
