Debugging and tools

Use these guidelines for debugging, logging, and updates.

Attach debugger to the Toolbox App

Create toolbox.vmoptions.
Check the following example:
agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=9797
Alternatively, suspend until attach. Check the following example:
agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=9797
Run Toolbox with VM args. Check the following example:
jetbrains-toolbox --jvm-args=/path/to/toolbox.vmoptions
Ensure no other Toolbox App process is running and attach to a running process from the IDE by invoking the Run | Attach to Process action.

Provide DiagnosticInfoCollector at provider/environment level to contribute plugin logs to bundles.
Use Logger from core/diagnostics as needed.

The application signals visibility is available via ProviderVisibilityState and EnvironmentVisibilityState.

Use these to throttle expensive updates and emit the initial state on listener addition.

If your plugin does not appear, check the plugin folder path, presence of the extension.json file, and the ServiceLoader file in your JAR.
Check logs in the Toolbox App folders; add a DiagnosticInfoCollector to bundle your plugin logs.
Ensure apiVersion is within the supported range.

11 September 2025