# Tools Find the full list of Serena's tools below. Note that in most configurations, only a subset of these tools will be enabled simultaneously. Tools marked as *optional* are disabled by default. Tools marked as [BETA] were recently introduced and may not be fully robust yet. ## Symbol Tools * `find_declaration`: Finds the declaration/definition of a symbol * `find_implementations`: Finds symbols that implement the given symbol using the language server backend. * `find_referencing_symbols`: Finds symbols that reference the given symbol using the language server backend * `find_symbol`: Performs a global (or local) search using the language server backend. * `get_diagnostics_for_file`: Gets diagnostics for a file, optionally restricted to a line range, grouped by file, severity, and containing symbol. * `get_diagnostics_for_symbol` *(optional)*: Gets diagnostics for a symbol and, optionally, for symbols that reference it. * `get_symbols_overview`: Gets an overview of the top-level symbols defined in a given file. * `insert_after_symbol`: Inserts content after the end of the definition of a given symbol. * `insert_before_symbol`: Inserts content before the beginning of the definition of a given symbol. * `rename_symbol`: Renames a symbol throughout the codebase using language server refactoring capabilities. For JB, we use a separate tool. * `replace_symbol_body`: Replaces the full definition of a symbol using the language server backend. * `restart_language_server` *(optional)*: Restarts the language server(s). * `safe_delete_symbol`: ## JetBrains Tools * `jet_brains_debug` *(optional)* [BETA]: Provides debugging functionality (run configs, breakpoints, stepping, inspection, and evaluation) via a persistent debug REPL connected to the JetBrains IDE. * `jet_brains_find_declaration` *(optional)*: Finds the declaration of a symbol using the JetBrains backend * `jet_brains_find_implementations` *(optional)*: Finds the implementations of a symbol using the JetBrains backend * `jet_brains_find_referencing_symbols` *(optional)*: Finds symbols that reference the given symbol using the JetBrains backend * `jet_brains_find_symbol` *(optional)*: Performs a global (or local) search for symbols using the JetBrains backend * `jet_brains_get_symbols_overview` *(optional)*: Retrieves an overview of the top-level symbols within a specified file using the JetBrains backend * `jet_brains_inline_symbol` *(optional)* [BETA]: Inlines a symbol using the JetBrains backend, replacing all call sites with the symbol's body * `jet_brains_list_inspections` *(optional)*: Lists available JetBrains IDE inspections, optionally filtered by language or group. * `jet_brains_move` *(optional)* [BETA]: Moves a symbol, file or directory to a new location using the JetBrains backend, updating all references * `jet_brains_rename` *(optional)*: Renames a symbol, file or directory throughout the codebase using the JetBrains backend. * `jet_brains_run_inspections` *(optional)*: Runs JetBrains IDE inspections on a file and returns the results. * `jet_brains_safe_delete` *(optional)* [BETA]: Safely deletes a symbol using the JetBrains backend, checking for remaining usages first * `jet_brains_type_hierarchy` *(optional)*: Retrieves the type hierarchy (supertypes and/or subtypes) of a symbol using the JetBrains backend ## Command Tools * `execute_shell_command`: Executes a shell command. ## Config Tools * `activate_project`: Activates a project based on the project name or path. * `get_current_config`: Prints the current configuration of the agent, including the active and available projects, tools, contexts, and modes. * `open_dashboard` *(optional)*: Opens the Serena web dashboard in the default web browser. The dashboard provides logs, session information, and tool usage statistics. * `remove_project` *(optional)*: Removes a project from the Serena configuration. ## File Tools * `create_text_file`: Creates/overwrites a file in the project directory. * `delete_lines` *(optional)*: Deletes a range of lines within a file. * `find_file`: Finds files in the given relative paths * `insert_at_line` *(optional)*: Inserts content at a given line in a file. * `list_dir`: Lists files and directories in the given directory (optionally with recursion). * `read_file`: Reads a file within the project directory. * `replace_content`: Replaces content in a file (optionally using regular expressions). * `replace_in_files`: Replaces occurrences of a pattern across multiple files, with dry-run preview and per-occurrence selection. * `replace_lines` *(optional)*: Replaces a range of lines within a file with new content. * `search_for_pattern`: ## Memory Tools * `delete_memory`: Delete a memory file. * `edit_memory`: Replaces content matching a regular expression in a memory. * `list_memories`: Lists available memories. * `read_memory`: Reads the content of a memory file. * `rename_memory`: Renames or moves a memory, updating references that are marked with the `mem:` prefix. * `write_memory`: Write some information (utf-8-encoded) about this project that can be useful for future tasks to a memory in md format. The memory name should be meaningful. ## Query Project Tools * `list_queryable_projects` *(optional)*: Tool for listing all projects that can be queried by the QueryProjectTool. * `query_project` *(optional)*: Tool for querying external project information (i.e. information from projects other than the current one), by executing a read-only tool. ## Workflow Tools * `initial_instructions`: Provides instructions Serena usage (i.e. the 'Serena Instructions Manual') for clients that do not read the initial instructions when the MCP server is connected. * `onboarding`: Performs onboarding (identifying the project structure and essential tasks, e.g. for testing or building). * `serena_info` *(optional)*: Provides information about an advanced topic on demand, facilitating context-efficiency.