Best base class for references code vision?

IntelliJ Platform
1

I was looking at adding “ usages” next to function/method declarations.

In intellij-community, the existing implementations (Java and Kotlin) moved from base class ReferencesCodeVisionProvider to RenameAwareReferencesCodeVisionProvider.

But in 2026.2, RenameAwareReferencesCodeVisionProvider was made @Internal.
The documentation page does not yet cover this.

What is the recommendation to implement “ usages” code vision?

3

Hello, TL;DR is: it is better to use ReferencesCodeVisionProvider.

This base class is a DaemonBoundCodeVisionProvider which “should be used in cases when code vision entries are related to PSI, so that calculated values are invalidated and recalculated on PSI changes”, so unless your case does not fit that, please use ReferencesCodeVisionProvider.

RenameAwareReferencesCodeVisionProvider is a workaround to solve some UX awkwardness when interacting with the suggested refactoring feature, but this approach has caused us headaches (CodeVisionProvider is tricky to use correctly) and we might reconsider it.

4

Thank for your reply, I’ll stick with the ReferencesCodeVisionProvider. The python implementation in intellij-community seems decent enough to get it right with a proven pattern.