diff --git a/README.md b/README.md index feba7f7b..84519fa1 100644 --- a/README.md +++ b/README.md @@ -17,6 +17,25 @@ approaches that rely on low-level concepts like line numbers or primitive search Practically, this means that your agent operates **faster, more efficiently and more reliably**, especially in larger and more complex codebases. +## How Serena Works + +Serena provides the necessary [tools](https://oraios.github.io/serena/01-about/035_tools.html) for coding workflows, +but an LLM is required to do the actual work, orchestrating tool use. + +Serena can extend the functionality of your existing AI client via the **model context protocol (MCP)**. +Most modern AI chat clients directly support MCP, including +* terminal-based clients like Claude Code, Codex, OpenCode, or Gemini-CLI, +* IDEs and IDE assistant plugins for VSCode, Cursor and JetBrains IDEs, +* desktop and local web clients like Claude Desktop or OpenWebUI + + + +To connect the Serena MCP server to your client, you typically + * provide the client with a launch command that starts the MCP server, or + * start the Serena MCP server yourself in HTTP mode and provide the client with the URL. + +See the [Quick Start](#quick-start) section below for information on how to get started. + ## Features Serena supports two code intelligence backends: diff --git a/resources/serena-block-diagram.afdesign b/resources/serena-block-diagram.afdesign new file mode 100644 index 00000000..49b898a1 Binary files /dev/null and b/resources/serena-block-diagram.afdesign differ diff --git a/resources/serena-block-diagram.svg b/resources/serena-block-diagram.svg new file mode 100644 index 00000000..7cccd011 --- /dev/null +++ b/resources/serena-block-diagram.svg @@ -0,0 +1 @@ + \ No newline at end of file