Plugin packaging

Check a small bootstrap project as an example.

Place your plugin artifacts under the following Toolbox App plugins directory (dev/unpacked form):

~/Library/Caches/JetBrains/Toolbox/plugins/<plugin-id>

$XDG_CACHE_HOME/JetBrains/Toolbox/plugins/<plugin-id>

If $XDG_CACHE_HOME is not set then the following directory is used:

~/.cache/JetBrains/Toolbox/plugins/<plugin-id>

%LOCALAPPDATA%/JetBrains/Toolbox/cache/plugins/<plugin-id>

Check the required files:

Your plugin JAR(s). Do not bundle the Toolbox App dependencies; they are provided by the application.
extension.json (generated from your build configuration)
Optional: Use icon.svg for plugin icons
Optional: dependencies.json when required by compliance

Use the following recommended structure

plugins/<plugin-id>/
  extension.json
  icon.svg
  my-plugin.jar
    

Check the following Gradle copy task example:

val installPlugin by tasks.registering(Copy::class) {
    from(layout.buildDirectory.dir("libs"))
    into(File(System.getProperty("user.home"), "Library/Caches/JetBrains/Toolbox/plugins/com.example.toolbox.myplugin"))
    include("*.jar")
}
    

10 February 2026