ISSUE 086  ·  17 NOVEMBER 2026 ELEN RSS
CodeCity
DEVELOPMENT № 0006

Serena — IDE powers on the codebase, through language servers

Serena gives the agent what an IDE has over code. Everything goes through MCP.

Serena — IDE-δυνάμεις πάνω στο codebase, μέσω language servers

What it does

Serena gives the agent what an IDE has over code. Everything goes through MCP.

Forget blind search and replace. It works with symbols. It finds declarations. It finds who calls a symbol. It renames. It changes the body of a symbol. It returns diagnostics per file.

Under all of that sit LSP language servers. That is the free option and the default.

On the LSP backend it covers more than 40 languages. From C/C++ and Rust to Zig and Wolfram.

What it does not do

Do not expect Serena to run code, find runtime bugs, or write full features for you. It works only with static symbols and whatever the language server gives it. In languages with dynamic dispatch, reflection, or generated code, the “who calls it” and refactor results can come back incomplete or wrong.

It does not replace a full IDE with debugging, profiling, or a test runner. It does not do semantic inference beyond LSP data. Where the language server is weak, rename and change-body break. If your project has tools or build steps that generate code later, you need manual indexing or a separate pipeline.

Do not ask it to keep state across large LLM sessions without the alpha hooks — Claude forgets tools if you do not set it up correctly. And if you plan to bind Serena into a closed product, ask a lawyer about GPL-3 before you move ahead.

Who it is for

For work on a real codebase. Cross-file rename, refactor, “who calls this.” Not for small text fixes.

Installation

The only thing you need is uv.

uv tool install -p 3.13 serena-agent

It downloads Serena and its executables.

serena init

It sets up the global config.

One note from the creator: do not take it from MCP or a plugin marketplace. Those sources give outdated commands.

Use with each LLM

Claude Code

The simplest path:

serena setup claude-code

It sets up the connection on its own.

If you want it manually, for all projects:

claude mcp add --scope user serena -- serena start-mcp-server --context claude-code --project-from-cwd

It registers Serena as an MCP server.

The documentation also suggests hooks. They are alpha. Without them, Claude forgets Serena’s tools when the session gets long.

Codex CLI

serena setup codex

Or manually in ~/.codex/config.toml.

One point: the Codex app does not open in the project folder. Tell it from the start to set the current folder as the project.

Cursor

It has no dedicated setup target. You set it up as an MCP server with the general config. Use –context ide so the tools do not overlap with Cursor’s own.

Where it wins, where it loses

It wins on depth. It works with symbols, not screenshots. You do not pay for vision you do not need.

It loses on license. The application is GPL-3.0-or-later. If you are building a closed product, ask a lawyer before you bind it.

And the quality depends on each language’s language server. Where the server is weak, rename breaks too.

The license needs care

Serena does not have one simple license. The repo is per-component. The SolidLSP core is MIT. The application is GPL-3.0-or-later. The LICENSE says it clearly: the serena-agent package combines both, so as a whole it goes under GPL.

That is not retroactive. v1.7.0 was the last one with MIT. From v2 it changes. The GitHub API shows it as NOASSERTION. The README badge and PyPI say MIT. Both are confusing.

Test

I installed it for real. On uv 0.12.15, Windows x86_64.

uv tool install -p 3.13 serena-agent

It passed without trouble. serena-agent 1.7.0. Three executables.

serena --version

It returned Serena 1.7.0.

What I did not do: I did not run serena init, because it is interactive. I did not index a real project. What I write about behavior inside the agent comes from the documentation.

Verdict

The strongest tool in the category for work on a real codebase. It is not for small fixes. It is for cross-file rename, refactor, and “who calls this” — where the alternative is ten brittle steps.

Score: 8.5/10.

See also

If this helped, see also:

  • ty: Astral’s type checker that catches the mistake before it runs
  • cf: Cloudflare’s new CLI that does not guess flags
  • ast-grep: grep that understands code, not text

Sources:

https://github.com/oraios/serena

https://github.com/oraios/serena/blob/main/LICENSE

https://oraios.github.io/serena/01-about/060_license.html

https://oraios.github.io/serena/02-usage/030_clients.html

https://oraios.github.io/serena/01-about/035_tools.html

https://pypi.org/project/serena-agent/

https://api.github.com/repos/oraios/serena

Εγκατάσταση

1 ΒΗΜΑ
  1. uv tool install -p 3.13 serena-agent
Serena — IDE powers on the codebase, through language servers · ΑΠΟΤΕΛΕΣΜΑ 8.5/10
ΠΗΓΗ
github.com/oraios/serena