This feature enables configuration-less debugging for Java applications, similar to the JavaScript Debug Terminal in VS Code.

When you open a terminal in VS Code with this extension installed, the following environment variables are automatically set:

• VSCODE_JDWP_ADAPTER_ENDPOINTS: Path to a communication file for port exchange
• PATH: Includes the debugjava command wrapper

Note: JAVA_TOOL_OPTIONS is NOT set globally to avoid affecting other Java tools (javac, maven, gradle). Instead, it's set only when you run the debugjava command.

Instead of running:

java -cp . com.example.Main

Simply run:

debugjava -cp . com.example.Main

The debugger will automatically attach, and breakpoints will work without any launch.json configuration!

debugjava -jar target/myapp.jar

debugjava -jar build/libs/myapp.jar

debugjava -cp . com.example.Main arg1 arg2 --flag=value

debugjava -jar myapp.jar --spring.profiles.active=dev

1. No Configuration Required: No need to create or maintain launch.json
2. Rapid Prototyping: Perfect for quick debugging sessions
3. Script Debugging: Debug applications launched by complex shell scripts
4. Environment Consistency: Inherits all terminal environment variables
5. Parameter Flexibility: Easy to change arguments using terminal history (↑ key)

1. When you run debugjava, the wrapper script temporarily sets JAVA_TOOL_OPTIONS=-agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=0
2. The wrapper determines which Java executable to use (priority order):
   • First: JAVA_HOME/bin/java if JAVA_HOME environment variable is set (user's explicit choice)
   • Second: VSCODE_JAVA_EXEC environment variable (Java path from VS Code's Java Language Server)
   • Third: java command from system PATH
3. The wrapper launches the Java process with JDWP enabled
4. JVM starts and outputs: "Listening for transport dt_socket at address: 12345"
5. The wrapper captures the JDWP port from this output
6. The port is written to a communication file
7. VS Code's file watcher detects the file and automatically starts an attach debug session

If you see "Address already in use", another Java debug session is running. Terminate it first.

1. Ensure you're running with debugjava command (not plain java)
2. Check that the debugjava command is available: which debugjava (Unix) or Get-Command debugjava (PowerShell)
3. Verify the terminal was opened AFTER the extension activated
4. Check the Debug Console for error messages

The wrapper script requires Node.js to be installed and available in PATH.

• Requires Node.js to be installed and available in PATH
• Only works in terminals opened within VS Code
• Requires using the debugjava command instead of java
• The Java process will suspend (hang) until the debugger attaches

• Debugger for Java Documentation
• JDWP Documentation