From 49524ab155594742cadc5ce941b86bf5c55255ee Mon Sep 17 00:00:00 2001 From: "Dr. Dominik Jain" Date: Fri, 17 Apr 2026 15:55:36 +0200 Subject: [PATCH] Update README * Add "Quick Demo" section with new videos * Remove old section "Serena in Action" * Update section "How Serena Works", removing redundant part explaining backends (this is what the next section handles) --- README.md | 35 +++++++++-------------------------- 1 file changed, 9 insertions(+), 26 deletions(-) diff --git a/README.md b/README.md index 84cb122f..d26bdad8 100644 --- a/README.md +++ b/README.md @@ -28,6 +28,12 @@ more complex codebases. > Do not install Serena via an MCP or plugin marketplace! They contain outdated and suboptimal installation commands. > Instead, follow our [Quick Start](#quick-start) instructions. +## Quick Demo + +https://github.com/user-attachments/assets/8d11646e-b80e-4723-b9d7-32d6101b5f58 + +:tv: Longer video: [Introduction to Serena in 5 Minutes (YouTube)](https://www.youtube.com/watch?v=5QN7gN1KYLA) + ## What Our "End Users" Say While it is humans who download and set up Serena, our end users are essentially AI agents. @@ -72,16 +78,12 @@ Most modern AI chat clients directly support MCP, including +:tv: See also: [Introduction to Serena in 5 Minutes (YouTube)](https://www.youtube.com/watch?v=5QN7gN1KYLA) + To connect the Serena MCP server to your client, you either * provide the client with a launch command that allows it to start the MCP server, or * start the Serena MCP server yourself in HTTP mode and provide the client with the URL. -Serena's tools are powered by two alternative language intelligence backends: - * With the SolidLSP backend (default), language servers for the selected programming languages will be started -automatically for your project. - * With the JetBrains backend, the Serena JetBrains plugin must be installed in your IDE and -the project you want to work on must open and set up. - See the [Quick Start](#quick-start) section below for information on how to get started. ## Programming Language Support & Semantic Analysis Capabilities @@ -97,7 +99,7 @@ There are two alternative technologies powering these capabilities: * **Language servers** implementing the language server protocol (LSP) — the free/open-source alternative which is used by default. -* The **Serena JetBrains Plugin**, which leverages the powerful code analysis and editing +* **The Serena JetBrains Plugin**, which leverages the powerful code analysis and editing capabilities of your JetBrains IDE (paid plugin; free trial available). You can choose either of these backends depending on your preferences and requirements. @@ -203,25 +205,6 @@ To achieve this, Serena offers multiple levels of (composable) configuration: -## Serena in Action - -
-Demonstrations - -#### Demonstration 1: Efficient Operation in Claude Code - -A demonstration of Serena efficiently retrieving and editing code within Claude Code, thereby saving tokens and time. Efficient operations are not only useful for saving costs, but also for generally improving the generated code's quality. This effect may be less pronounced in very small projects, but often becomes of crucial importance in larger ones. - -https://github.com/user-attachments/assets/ab78ebe0-f77d-43cc-879a-cc399efefd87 - -#### Demonstration 2: Serena in Claude Desktop - -A demonstration of Serena implementing a small feature for itself (a better log GUI) with Claude Desktop. -Note how Serena's tools enable Claude to find and edit the right symbols. - -https://github.com/user-attachments/assets/6eaa9aa1-610d-4723-a2d6-bf1e487ba753 -
- ## Quick Start **Prerequisites**. Serena is managed by *uv*, and [installing uv](https://docs.astral.sh/uv/getting-started/installation/) is the only required prerequisite.