Merge pull request #882 from ximot/feature/open-dashboard-tool

feat: Add open_dashboard MCP tool for on-demand dashboard opening

docs/01-about/035_tools.md

@@ -28,6 +28,7 @@ Note that in most configurations, only a subset of these tools will be enabled s
 * `list_dir`: Lists files and directories in the given directory (optionally with recursion).
 * `list_memories`: Lists memories in Serena's project-specific memory store.
 * `onboarding`: Performs onboarding (identifying the project structure and essential tasks, e.g. for testing or building).
+* `open_dashboard`: Opens the Serena web dashboard in the default web browser.
 * `prepare_for_new_conversation`: Provides instructions for preparing for a new conversation (in order to continue with th
   e necessary context).
 * `read_file`: Reads a file within the project directory.

docs/02-usage/060_dashboard.md

@@ -15,8 +15,21 @@ Serena comes with built-in tools for monitoring and managing the current session
 * the **GUI tool** (disabled by default)
   
   The GUI tool is a native application window which displays logs.
+  It furthermore allows you to shut down the agent and to access the dashboard's URL (if it is running). 
 
   This is mainly supported on Windows, but it may also work on Linux; macOS is unsupported.
 
 Both can be configured in Serena's [configuration](050_configuration) file (`serena_config.yml`).
 If enabled, they will automatically be opened as soon as the Serena agent/MCP server is started.
+For the dashboard, this can be disabled if desired (see below).
+
+## Disabling Automatic Browser Opening
+
+If you prefer not to have the dashboard open automatically (e.g., to avoid focus stealing), you can disable it
+by setting `web_dashboard_open_on_launch: False` in your `serena_config.yml`.
+
+When automatic opening is disabled, you can still access the dashboard by:
+* asking the LLM to "open the Serena dashboard", which will open the dashboard in your default browser
+  (the tool `open_dashboard` is enabled for this purpose, provided that the dashboard is active, 
+  not opened by default and the GUI tool, which can provide the URL, is not enabled)
+* navigating directly to the URL (see above)