Supermaven still works.
Here's the fix.

Supermaven is by far the fastest code autocomplete for JetBrains IDEs — but it was abandoned after the Cursor acquisition in late 2024 and no longer loads on newer IDE builds. This page has patched versions you can install in one click.

The problem

After updating your JetBrains IDE (IntelliJ, CLion, WebStorm, PyCharm, GoLand, Rider, etc.) you see this error when trying to use Supermaven:

Error

Plugin 'Supermaven' (version '1.43') is not compatible with the current version of the IDE, because it requires build 252.* or older but the current build is XXX.

JetBrains error dialog: Plugin Supermaven version 1.43 is not compatible with the current version of the IDE because it requires build 252 or older
The error you see after updating your IDE past build 252.

The plugin itself works fine — it's just a version ceiling in its metadata (until-build="252.*") that tells the IDE to reject it. Since Supermaven was abandoned, nobody shipped an update to raise that ceiling. Until now.

The fix: download a patched build

Solution

Download the .jar matching your IDE build number and install it via Install Plugin from Disk. That's it — Supermaven works exactly like before.

1. Find your IDE build number

Open your JetBrains IDE and go to Help → About (macOS: App Name → About). Look for the build number — the first three digits are what you need.

CLion About dialog showing build number CL-253.30387.78
Example: CLion 2025.3.2 → build 253.30387.78 → download the 253.* version.

2. Download the matching .jar

252.*
2025.2
Download
253.*
2025.3
Download
254.*
2025.4
Download
255.*
2025.5
Download
256.*
2026.1
Download
257.*
2026.2
Download
258.*
2026.3
Download
259.*
2026.4
Download

3. Install the plugin

In your IDE go to Settings → Plugins → gear icon (⚙) → Install Plugin from Disk…, select the downloaded .jar, and restart.

JetBrains Settings showing Plugins page with gear icon menu and Install Plugin from Disk option
Settings → Plugins → gear icon → Install Plugin from Disk.

Patch it yourself (for future IDE versions)

If your IDE build isn't listed above, you can patch the original .jar yourself with the included shell script. This takes about 10 seconds.

  1. Open update-vers-and-pack.sh and set your target version: 
    TARGET_INTELLIJ_VERSION="258.*"   # ← change to match your IDE
  2. Run: 
    bash update-vers-and-pack.sh
    The script uses any existing .jar from jar/ as a base — no extra download needed.
  3. Install jar/supermaven-1.43-patched.jar via Install Plugin from Disk.

What does the script do?

It unzips the JAR, changes until-build="252.*" in META-INF/plugin.xml to your target version, and repacks it. That single attribute is the only thing preventing the plugin from loading.

Bug fix note

An earlier version of this script had a hardcoded sed pattern (until-build="243.*") that silently failed when the JAR contained a different version. The current script uses a generic regex [^"]* that matches any value.

Credits

Supermaven
Built the plugin. Still the fastest autocomplete out there — even after being abandoned following the Cursor acquisition. The million-token context window is genuinely impressive engineering.
Tomasz Mikus
Figured out the version-ceiling patch and wrote it up so everyone could keep using Supermaven. Huge thanks.