How to Download and Set Up Supermaven in Your Code Editor
Updated
Supermaven is a code completion tool that works with VS Code, JetBrains IDEs, and Neovim, and you can start using it on the free tier. Setup means downloading the editor extension, signing in, and letting it index your project so it can suggest code as you type. The main caveats: the free tier keeps data for 7 days, and the 1 million token context window, style adaptation, and largest model are Pro-only features.
Before you install
Check these three things first:
- Editor support: Supermaven ships for VS Code, JetBrains IDEs, and Neovim. If you use a different editor, it won't work.
- Plan: The Free tier is $0/month and includes fast, high-quality suggestions that work with large codebases. Pro is $10/month (monthly or yearly) and adds the 1 million token context window, style adaptation, the largest model, and $5/month in Supermaven Chat credits. Pro comes with a 30-day free trial.
- Account: You'll need to sign in to activate the extension, even on the free tier.
Step-by-step setup
1. Download from the Supermaven website
Go to supermaven.com and use the Download option. The site presents the download for VS Code, JetBrains, and Neovim from the same page, so pick the one matching your editor.
2. Install the extension in your editor
- VS Code: install the Supermaven extension, then reload the window if prompted.
- JetBrains IDEs: install the Supermaven plugin from the marketplace and restart the IDE.
- Neovim: follow the plugin installation instructions from the download page, then restart Neovim.
3. Sign in and let it index
After installation, sign in with your Supermaven account. The extension then reads your project so it can produce contextual suggestions. In the example shown on the site, Supermaven finds the definition of PostMetadata elsewhere in the codebase and uses it to suggest the correct fields — that's the indexing at work, and it's why suggestions improve once your project is loaded rather than on the first keystroke.
4. Verify it's working
Open a file you're actively editing and start typing a function or object. You should see inline suggestions appear as you type. If nothing shows up, confirm you're signed in and that the extension is enabled for the current workspace.
What you get after setup
- Inline completions as you type, using context from across your codebase.
- Supermaven Chat, which lets you talk to GPT-4o, Claude 3.5 Sonnet, GPT-4, and other models. Hotkeys let you view diffs, apply changes, start conversations, and switch models. You can attach recently edited files, and chat responses link back to your original code so you can see diffs and apply changes. You can also fix errors by uploading your code together with compiler diagnostics in one click.
- Speed: Supermaven reports 250 ms latency versus 783 ms for a leading competitor, which it describes as 3x faster responses.
Free vs Pro: what changes after install
| Feature | Free | Pro ($10/month) |
|---|---|---|
| Fast, high-quality suggestions | Yes | Yes |
| Works with large codebases | Yes | Yes |
| Data retention | 7 days | 7 days |
| Adapts to your coding style | No | Yes |
| 1 million token context window | No | Yes |
| Largest, most intelligent model | No | Yes |
| Supermaven Chat credits | No | $5/month |
| Trial | — | 30-day free trial |
If you're evaluating the tool, the free tier is enough to judge suggestion quality on your own code. Upgrade to Pro when you hit the context limit on a large codebase or want style adaptation.
Common snags
- No suggestions appearing: usually a sign-in or indexing issue. Re-check that you're logged in and that the extension has access to the project folder.
- Suggestions feel generic: on the free tier, Supermaven doesn't adapt to your coding style and doesn't use the 1 million token context window, so it sees less of a large codebase. Pro is what unlocks both.
- Editor not listed: only VS Code, JetBrains IDEs, and Neovim are supported, so there's no install path for other editors.