From b331183c76864a5ab540ee19f6d582ed55e9efce Mon Sep 17 00:00:00 2001 From: Dominik Jain Date: Thu, 23 Apr 2026 15:53:42 +0200 Subject: [PATCH] Update documentation to mention JetBrains debug tool --- CHANGELOG.md | 4 +++- README.md | 8 +++++++- docs/02-usage/025_jetbrains_plugin.md | 2 ++ 3 files changed, 12 insertions(+), 2 deletions(-) diff --git a/CHANGELOG.md b/CHANGELOG.md index 1a9c4006..c467cc96 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -31,7 +31,9 @@ Status of the `main` branch. Changes prior to the next official version change w The `initial_instructions` tool provides the full prompt on demand, keeping the initial context lean. * 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 diff --git a/README.md b/README.md index 7ee19813..0c819fb4 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,7 @@
-* 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. diff --git a/docs/02-usage/025_jetbrains_plugin.md b/docs/02-usage/025_jetbrains_plugin.md index 1995ca34..4eb08688 100644 --- a/docs/02-usage/025_jetbrains_plugin.md +++ b/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.