This plugin extends Protocol Buffer support in the IDE by integrating with Buf. It provides fast diagnostics, go-to-definition, code completion, hover documentation, and find references through the Buf Language Server (requires buf CLI v1.59.0+ and IntelliJ 2025.1+). The plugin automatically falls back to CLI-based diagnostics when the language server is unavailable or if using an older version of buf.
The plugin also supports code formatting with buf format,
background linting with buf lint,
breaking change detection with buf breaking,
and integration with Buf Schema Registry to help manage, discover and share API definitions.
Configure features in Settings → Tools → Buf.
Please submit bug reports and feature requests via GitHub Issues and don't hesitate to contribute via PRs.
Once you have Buf CLI installed locally just run ./gradlew test in your terminal or open the project in IntelliJ
and use Run Tests run configuration.
In order to run the plugin from sources either run ./gradlew runIde in your terminal or open the project in IntelliJ
and use Run Plugin run configuration.
To build a local distribution of the plugin which can be shared run ./gradlew buildPlugin from your terminal and
use build/distributions/intellij-buf-*.zip for sharing and installing from disk.
Process of publishing the plugin to JetBrains Marketplace is automated via GitHub Releases:
- Create a GitHub Release which will automatically submit the plugin for a review.
- After the review, which can take a day or two, the plugin will be available on JetBrains Marketplace.