Update documentation to mention JetBrains debug tool

Author: opcode81

CHANGELOG.md

@@ -28,7 +28,9 @@ Status of the `main` branch. Changes prior to the next official version change w
   - Fix: `search_for_pattern` tool returned 1-based line numbers (in contrast to all other tools); cause: implementation of `text_utils.search_text`
 
 * JetBrains:
-  - `Move` and `SafeDelete` tools: transform empty string to None (counteracts client errors)
+  - Add `debug` tool: The agent can set breakpoints, inspect variables, evaluate expressions and control execution flow
+    by directly interacting with the IDE's debugger, using a REPL-style interface for maximum flexibility.  
+  - `move` and `safe_delete` tools: transform empty string to None (counteracts client errors)
 
 * Dependencies:
   - `pywebview`: Switch back to official release (new version 6.2) #1253

README.md

@@ -14,7 +14,7 @@
 <br>
 
 
-* Serena provides essential **semantic code retrieval, editing and refactoring tools** that are akin to an IDE's capabilities,
+* Serena provides essential **semantic code retrieval, editing, refactoring and debugging tools** that are akin to an IDE's capabilities,
   operating at the symbol level and exploiting relational structure.
 * It integrates with any client/LLM via the model context protocol (**MCP**).
 
@@ -171,6 +171,12 @@ Serena's symbolic editing tools are less error-prone and much more token-efficie
 | insert before symbol   | yes               | yes              |
 | safe delete            | yes               | yes              |
 
+### Interactive Debugging
+
+Exclusive to the JetBrains plugin, Serena supports a highly general debugging tool,
+which allows an agent to set breakpoints, inspect variables, evaluate expressions and control execution flow 
+via a persistent REPL-style interface.
+
 ### Basic Features
 
 Beyond its semantic capabilities, Serena includes a set of basic utilities for completeness.

docs/02-usage/025_jetbrains_plugin.md

@@ -43,6 +43,8 @@ There are multiple features that are only available when using the JetBrains plu
 * **Enhanced retrieval & refactoring capabilities**: The plugin adds additional [tools](../01-about/035_tools) (e.g. type
   hierarchy retrieval, move, find declaration, inline symbol, etc.) 
   and transforms the underlying mechanisms of shared tools to build upon the IDE's capabilities.
+* **Interactive debugging**: The agent can set breakpoints, inspect variables, evaluate expressions and control execution flow
+  by directly interacting with the IDE's debugger, using a REPL-style interface for maximum flexibility.
 * **Improved multi-agent support**: A single IDE instance naturally serves arbitrarily many agent sessions without requiring additional resources.
 * **Enhanced performance**: Faster tool execution thanks to optimized IDE integration.
 * **Multi-language excellence** and **framework support**: First-class support for polyglot projects with multiple languages.