How do I install windsurf.nvim with lazy.nvim?

Add it as a dependency in your lazy.nvim config with nvim-cmp and plenary.nvim, then call the setup function. The README provides specific Lua code examples for both packer and lazy package managers.

windsurf.nvim vs GitHub Copilot for Neovim: which is better?

windsurf.nvim uses Windsurf's AI models and offers enterprise support, while Copilot.nvim integrates GitHub Copilot. Choose based on your preferred AI provider, pricing, and features like virtual text display or browser chat.

Why isn't windsurf.nvim showing any completions?

First, authenticate with :Codeium Auth and ensure internet access. Check that nvim-cmp is set up with the codeium source, and review the log file at ~/.cache/nvim/codeium/codeium.log for errors.

Can I use windsurf.nvim without nvim-cmp?

Yes, by disabling the cmp source and relying on virtual text only, but integration with other completion frameworks is limited. It's primarily designed for nvim-cmp users.

How to configure virtual text for specific filetypes?

In the setup options, set virtual_text.filetypes to a map like {python = true, markdown = false}, and adjust default_filetype_enabled. This allows fine-grained control over where completions appear.

Is windsurf.nvim free to use?

The plugin is open-source, but the underlying Windsurf AI service may have its own pricing or subscription model. Check Windsurf's documentation for current details on free tiers or costs.

Open-Awesome

windsurf.nvim

MITLua

A native Neovim plugin that integrates Windsurf's AI-powered code completion and chat functionality directly into the editor.

GitHub

1.3k stars107 forks0 contributors

What is windsurf.nvim?

windsurf.nvim is a native Neovim plugin that integrates Windsurf's AI-powered coding assistant directly into the Vim editor. It provides intelligent code completions, chat functionality, and workspace-aware suggestions to help developers write code faster and more efficiently. The plugin solves the problem of context switching between editors and AI tools by bringing AI assistance directly into the Neovim workflow.

Target Audience

Neovim users who want AI-powered code completion and assistance without leaving their editor, particularly developers who prefer Vim keybindings and workflows but want modern AI coding features.

Value Proposition

Developers choose windsurf.nvim because it provides native Neovim integration with Windsurf's AI capabilities, offering virtual text completions, seamless nvim-cmp integration, and workspace context awareness while maintaining the Vim philosophy and workflow.

Overview

A native neovim extension for Codeium

Use Cases

Best For

Adding AI-powered code completion to Neovim workflows
Getting context-aware suggestions while coding in Vim
Integrating AI chat assistance with Neovim projects
Self-hosting AI coding assistants in enterprise environments
Enhancing productivity for developers who prefer terminal-based editors
Extending nvim-cmp with AI completion sources

Not Ideal For

Developers requiring fully offline AI coding assistance without internet access
Users who prefer all AI interactions, including chat, to stay within the terminal
Teams using completion frameworks other than nvim-cmp in Neovim

Pros & Cons

Pros

Native Virtual Text Integration

Displays AI completions directly in the editor using Neovim's virtual text with configurable keybindings and filetype support, minimizing context switching.

Workspace-Aware Completions

Automatically detects project roots via LSP or version control markers, improving suggestion relevance based on current workspace context.

Enterprise Deployment Ready

Supports configurable API endpoints and proxy detection, making it suitable for self-hosted or corporate environments with custom setups.

Seamless nvim-cmp Integration

Registers as a source in the popular nvim-cmp framework, allowing easy addition to existing completion setups without major overhauls.

Cons

External API Dependency

Requires authentication and continuous internet access to Windsurf's servers, which can fail in offline environments or raise privacy concerns.

Browser-Dependent Chat

Chat functionality opens in a web browser, disrupting the terminal-centric workflow that many Neovim users prefer for a seamless experience.

Configuration Complexity

Setting up tools paths and workspace root detection can be cumbersome, especially on non-standard systems like NixOS, as noted in the README.

Open Source Alternative To

windsurf.nvim is an open-source alternative to the following products:

Tabnine

Tabnine is an AI-powered code completion tool that integrates with various IDEs and editors to provide intelligent code suggestions based on machine learning models trained on open-source code.

GitHub Copilot

GitHub Copilot is an AI-powered code completion tool that suggests lines or blocks of code as developers type, trained on public code repositories.

Frequently Asked Questions

Related Projects

avante.nvim

Use your Neovim like using Cursor AI IDE!

Stars17,841

Forks811

Last commit14 hours ago

codecompanion.nvim

✨ AI Coding, Vim Style

Stars6,519

Forks405

Last commit15 hours ago

ChatGPT.nvim

ChatGPT Neovim Plugin: Effortless Natural Language Generation with OpenAI's ChatGPT API

Stars4,003

Forks324

Last commit3 months ago

CopilotChat.nvim

Chat with GitHub Copilot in Neovim

Stars3,632

Forks170

Last commit4 days ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub