Skip to content

devkanro/intellij-protobuf-plugin

Logo IntelliJ Protobuf Language Plugin

Full-featured Protocol Buffers support for JetBrains IDEs

JetBrains Plugins Downloads Build

Semantic analysis · Cross-file navigation · Multi-language integration · Protobuf Editions


✨ What It Does

This plugin turns your JetBrains IDE into a protobuf-aware development environment — not just syntax highlighting, but deep understanding of your schema.

Warning

Not compatible with the bundled JetBrains Protocol Buffer plugin. Disable Protocol Buffer and gRPC before installing.

🚀 Quick Start

  1. Open Settings → Plugins → Marketplace
  2. Search for "Protobuf" by kanro
  3. Install and restart

🔍 Feature Highlights

Schema Intelligence

Understands your .proto files semantically — resolves types across files and imports, validates field numbers, checks naming conventions, and catches errors in real time.

Screenshot

Cross-File Navigation

Go-to-definition, find usages, and rename refactoring that works across files, packages, and even library proto definitions.

Reference resolution Reference

In-place rename Rename

Smart Editing

Auto-completion that understands context — types, field names, enum values, options. Auto-import and import optimization built in.

Auto import Auto Import

Import optimizer Import Optimizer

Multi-Language Integration

Module Features
Java / Kotlin Navigate between .proto and generated Java code
Go Go code navigation, decompile from proto descriptors
gRPC Send requests via HTTP Client, explore APIs via Endpoints
AIP Google API design spec validation and completion
Sisyphus Sisyphus Kotlin framework integration

Modern Protobuf

AIP Spec Support

Validates and auto-completes Google API Improvement Proposals — resource definitions, HTTP rules, and naming conventions.

AIP

🤖 Copilot-Powered Development

This project uses AI-assisted development with a structured workflow:

brainstorm → implement → ship → reflect

Every non-trivial change goes through a brainstorm (design discussion with a state machine), followed by implementation, shipping with quality gates, and post-ship reflection. Learnings accumulate in a knowledge base that feeds back into future work.

See .github/copilot-instructions.md for the workflow and .github/skills/ for the skill definitions.

📖 Documentation

Overview What the plugin does and why
Architecture How the pieces fit together
Getting Started Build, run, and test
Contributing Code style and how to add features
Design Docs Deep-dive into subsystem design decisions
Extension Points API for extending the plugin

🙏 Acknowledgments

Inspired by protobuf-jetbrains-plugin and intellij-protobuf-editor.

About

IntelliJ-based IDEs Protobuf Language Plugin that provides Protobuf language support.

Topics

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Contributors