java-debug

Controls IntelliJ debugger sessions to set breakpoints, step through code, and inspect runtime state.

Updated May 4, 2026
One-click install
npx skills add https://github.com/studenkov/FinanceTracker --skill java-debug-studenkov
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: java-debug
Source: https://github.com/studenkov/FinanceTracker/tree/main/.agents/skills/java-debug
Command: npx skills add https://github.com/studenkov/FinanceTracker --skill java-debug-studenkov

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Investigating why Java code misbehaves at runtime is slow when you can only read logs or guess from stack traces. This Skill gives an AI agent direct control over the IntelliJ debugger via the IntelliJ Debug MCP server, so it can set breakpoints, step through execution, and evaluate expressions in the live JVM. ## Core Features & Use Cases - Breakpoint Management: Add, remove, toggle, and set conditions on breakpoints at exact file and line positions. - Execution Control: Start debug sessions from run configurations, then resume, pause, step over, step into, and step out while verifying position after every step. - Runtime Inspection: Evaluate expressions in any stack frame, read stack traces, and list threads to understand how execution reached a given point. - Use Case: A user reports a NullPointerException in a Spring controller. The agent sets a conditional breakpoint, starts the app in debug mode, triggers the failing request with a timeout-safe curl call, inspects variable values, and traces the call stack to find the root cause. ## Quick Start Debug my Spring application by setting a breakpoint in the failing controller method and inspecting the variable values when it is hit.

Frequently Asked Questions about java-debug

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug a Java application with an AI agent?

Connect the IntelliJ Debug MCP server, initialize it with your project path, then set breakpoints and start a run configuration in debug mode. The agent can step through code, evaluate expressions, and read stack traces while the session is suspended.

How to set a conditional breakpoint in IntelliJ programmatically?

Use the add_breakpoint tool with filePath, a 1-based line number, and an optional condition string. You can later change the condition with set_breakpoint_condition, passing an empty string to remove it.

Why do my HTTP requests hang while debugging a Java app?

Requests hang because the application is suspended on a breakpoint and cannot respond. Always use a timeout such as curl --max-time 5, and check isSuspended via list_debug_sessions before making network calls.

Can I evaluate expressions in a running debug session?

Expression evaluation only works while the session is suspended on a breakpoint or after a step. Use evaluate_expression with an optional frameIndex to inspect variables in different stack frames, and avoid expressions with side effects.

What are the limitations of the IntelliJ Debug MCP server?

The server does not expose console stdout or stderr from the debugged app and does not push notifications when breakpoints are hit. You must check session state with list_debug_sessions or get_current_position after each relevant action.