diff --git a/CHANGELOG.md b/CHANGELOG.md index ff21db91..2bf65e78 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -18,11 +18,8 @@ Status of the `main` branch. Changes prior to the next official version change w * Reliably detect language server termination and propagate the respective error all the way back to the tool application, where an unexpected termination is handled by restarting the language server and subsequently retrying the tool application. - * Add comprehensive bash language support with bash-language-server integration - * Support for .sh and .bash file extensions - * Hybrid function detection (LSP + regex fallback) for reliable symbolic editing - * Automatic Node.js/npm dependency management - * Cross-platform compatibility including Windows + * **Add support for Swift** + * **Add support for Bash** * Enhance Solargraph (Ruby) integration * Automatic Rails project detection via config/application.rb, Rakefile, and Gemfile analysis * Ruby/Rails-specific exclude patterns for improved indexing performance (vendor/, .bundle/, tmp/, log/, coverage/) diff --git a/README.md b/README.md index 061b0687..0019c725 100644 --- a/README.md +++ b/README.md @@ -290,7 +290,12 @@ want to use Serena. ### Project Activation & Indexing -The recommended way is to just ask the LLM to activate a project by providing it an absolute path to, or, + +If you are mostly working with the same project, you can configure to always activate it at startup +by passing `--project ` to the `start-mcp-server` command in your client's MCP config. +This is especially useful for clients which configure MCP servers on a per-project basis, like Claude Code. + +Otherwise, the recommended way is to just ask the LLM to activate a project by providing it an absolute path to, or, in case the project was activated in the past, by its name. The default project name is the directory name. * "Activate the project /path/to/my_project" @@ -301,9 +306,6 @@ project, the file `.serena/project.yml` will be generated. You can adjust the la (which you refer to during the activation) or other options. Make sure to not have two different projects with the same name. -If you are mostly working with the same project, you can also configure to always activate a project at startup -by passing `--project ` to the `start-mcp-server` command in your client's MCP config. - ℹ️ For larger projects, we recommend that you index your project to accelerate Serena's tools; otherwise the first tool application may be very slow. To do so, run this from the project directory (or pass the path to the project as an argument): @@ -336,7 +338,7 @@ claude mcp add serena -- uvx --from git+https://github.com/oraios/serena serena to "read Serena's initial instructions" or run `/mcp__serena__initial_instructions` to load the instruction text. If you want to make use of that, you will have to enable the corresponding tool explicitly by adding `initial_instructions` to the `included_optional_tools` in your config. - Note that you may have to make Claude read the instructions you start a new conversation and after any compacting operation to ensure Claude remains properly configured to use Serena's tools. + Note that you may have to make Claude read the instructions when you start a new conversation and after any compacting operation to ensure Claude remains properly configured to use Serena's tools. ### Other Terminal-Based Clients @@ -401,7 +403,7 @@ community version](https://github.com/aaddrick/claude-desktop-debian). ⚠️ Be sure to fully quit the Claude Desktop application, as closing Claude will just minimize it to the system tray – at least on Windows. -⚠️ Some clients, currently including Claude Desktop, may leave behind zombie processes. You will have to find and terminate them manually then. +⚠️ Some clients may leave behind zombie processes. You will have to find and terminate them manually then. With Serena, you can activate the [dashboard](#serenas-logs-the-dashboard-and-gui-tool) to prevent unnoted processes and also use the dashboard for shutting down Serena.