tokenade
GitHubenfr
Install

Serena Alternatives: 6 Tools Compared

Six serena alternatives for AI coding agents, ranked on measured session cost, how they understand code, install weight and licence, with the honest limits of each.

TL;DR — Tokenade is the serena alternative to pick if you wanted a cheaper session: it is the only tool on the open THOL benchmark that measurably cut session cost, and serena was never measured there. For code navigation without language servers, codegraph is the closest swap; tokensave adds edit primitives in one Rust binary, CodeGraphContext a graph database, code-review-graph change impact and claude-context vector search.

Profile photo of Paul Irolla

By Paul Irolla

Founder · AI & developer tools · Tokenade

Ph.D. in AI · builds token-optimization tooling for AI agents

View author page
11 min read
Cite this page

What should you use instead of serena?

If you installed serena to make your AI agent cheaper, use Tokenade: it is the only one of the twelve tools in the open THOL benchmark that measurably lowered what a session costs, and serena isn't in that benchmark at all. If you want code navigation without running language servers, codegraph is the closest swap.

Let me be clear about the anchor first: serena is excellent at what it does. It drives real language servers (LSP), so when your agent asks for the references to a symbol, the answer comes from the same engine your IDE uses. No index in this list matches that precision, mine included.

The reasons people look elsewhere are specific:

  • The licence changed. Since v2.0.0 (13 October 2026), the Serena application is GPL-3.0-or-later; only its SolidLSP layer stays MIT. Earlier releases remain MIT.
  • It runs a language server per language. Some languages need extra dependencies, and each server has to start and index before it answers.
  • The deepest refactors are in the paid plugin. Move, inline and type hierarchy are listed for the JetBrains plugin, not the free language-server backend.
  • The bill is a side effect. serena saves tokens when a symbol read replaces a file read. It doesn't market cost savings, and nobody has measured its effect on a whole session.

Disclosure before the ranking: I maintain the THOL benchmark and I build Tokenade. The benchmark is public and reproducible, and it includes results that don't flatter my tool, but it is not an independent third party.

Features, licences and release notes read on each project's GitHub page on 2026-10-15. Session-cost figures come from the published THOL campaign (Claude Code 2.1.206, Claude Sonnet 4.6, long sessions), the only one this site quotes.

The short list

ToolWhat it isEntry priceBest for
TokenadeA binary between your agent and its tools: output filtering, file-read trimming, code search, document and media readingFree, open source (MIT/Apache-2.0)A measured drop in session cost
codegraphA pre-indexed code knowledge graph that syncs on file changesFree (MIT)The closest navigation swap, no language servers
tokensaveA Rust MCP server with a code graph and edit primitivesFree (MIT)Polyglot repos, single binary
CodeGraphContextA CLI and MCP server indexing code into a graph databaseFree (MIT)Call-chain questions across many files
code-review-graphA Tree-sitter code graph served over MCP, built for reviewFree (MIT)Change impact and review context
claude-contextHybrid keyword and vector code search over MCPFree (MIT) + vector DB and embedding costsSearch by meaning, if you run the infra

How did we pick these?

Five criteria, applied identically to every entry including mine.

  • Measured session cost. End to end, against a no-tool control, from THOL. Where a tool isn't in the campaign, the table says "Not measured" and any vendor figure stays in prose, attributed, with its scope.
  • How it understands code. Compiler-grade language servers, a parsed graph, regex, or vector embeddings: four very different guarantees.
  • Freshness. Live from the language server, a graph that syncs itself, or an index you re-run.
  • Install weight. A Python tool, a graph database, a vector service or a single binary.
  • Licence. GPL, MIT or proprietary, which matters more since serena's v2 change.

1. Tokenade — the one measured to lower session cost

Tokenade is the strongest serena alternative on the criterion most people actually care about: it is the only tool of the twelve in the open benchmark that measurably reduced what a session costs.

  • What it is: a binary between your AI agent and its tools. It filters command output, trims file reads to structure first, folds MCP results and runs on-device code search, with a local savings report (tokenade dashboard).
  • Strengths: on long sessions it makes a session 39% cheaper than the agent on its own. It works on the cost sources a code navigator never sees: test logs, build output, MCP payloads. tokenade read also turns PDFs, Office files, images, audio and video into text on demand.
  • Code structure: tokenade map, skeleton, query, impact and semantic answer layout, signature, symbol, dependents and meaning questions, with no language server to install. They are covered in the code intelligence docs.
  • Limitations: serena beats it on precision, and I won't pretend otherwise. Tokenade's symbol answers come from parsing and retrieval, not a compiler, and it has no symbol-level editing or rename. And it's my product, so weight this accordingly.
  • Best for: anyone who wants the bill to move, on more than one AI agent. The attribute view is on Tokenade vs serena.

2. codegraph — the closest navigation swap

codegraph is the serena alternative to pick if you want your agent to answer structure questions from an index, without starting a language server per language.

  • What it is: a pre-indexed knowledge graph of symbols, call edges and dependencies, served over MCP. Its installer wires it into Claude Code, Cursor, Codex CLI, opencode, Gemini CLI, GitHub Copilot and others. MIT.
  • Strengths: auto-sync is on by default, so the graph follows every file change. Its README is unusually candid: it reports 44% lower cost and 62% fewer tokens per answer across seven benchmark repos, and in the same section says the graph leaves about 80% more retrieval context in the window at the end of a session.
  • Limitations: that 44% was measured per architecture question on its own harness, not on whole sessions. In THOL it showed no measurable difference. Navigation is parsed, not compiler-resolved, and there is no symbol-level editing.
  • Best for: teams who liked serena's "ask, don't grep" model but not the language-server setup. See Tokenade vs CodeGraph.

3. tokensave — a free Rust graph with edit primitives

tokensave is the serena alternative closest to its editing side, because it ships writer tools as well as queries, in one native binary.

  • What it is: a Rust MCP server with a pre-indexed code graph. Its README lists 80+ MCP tools and 50+ languages, and four edit primitives that let agents modify files without regex or shell quoting. Install via Homebrew, Scoop or cargo. MIT.
  • Strengths: no Python environment and no language server to manage. Cross-branch tools query other branches without switching your checkout, which serena doesn't offer.
  • Limitations: its graph is built by parsing, so a rename is not the compiler-checked operation serena's LSP backend performs. Not in the published THOL campaign, so not measured on session cost.
  • Best for: polyglot repos where one binary beats a fleet of language servers. See tokensave alternatives.

4. CodeGraphContext — call chains in a graph database

CodeGraphContext is the serena alternative when your hardest questions are about execution flow: who calls this, through how many layers, across hundreds of files.

  • What it is: an MCP server plus a CLI that indexes local code into a graph database. Its README lists 23 languages and several backends: FalkorDB Lite by default on Unix, KuzuDB, or Neo4j over Docker. Installed with pip install codegraphcontext. MIT, about 4,300 GitHub stars when I checked.
  • Strengths: direct and indirect callers and callees are a graph query, not a chain of reference lookups. It can watch a directory and keep the graph updated as files change. It also offers an opt-in output format that its README says cuts tool-response tokens by about 62%, a figure for response size, not session cost.
  • Limitations: a graph database is more moving parts than serena, not fewer, once you leave the embedded default. No compiler-grade resolution, no symbol editing. Not in THOL, so not measured.
  • Best for: large codebases where tracing dependencies matters more than editing.

5. code-review-graph — the graph, aimed at review

code-review-graph is the serena alternative when the question you actually ask is "what does this change touch".

  • What it is: a Python MCP server that parses the repo with Tree-sitter into a structural map and keeps it updated incrementally. code-review-graph install configures each AI coding tool it finds. MIT.
  • Strengths: blast-radius analysis traces every caller, dependent and test of a changed file, so the assistant reads only those. Reviews are where agents re-read the most, which makes this a precise target.
  • Limitations: its headline figure is a median per-question token reduction of about 63x against feeding the corpus, a baseline no real agent uses. In THOL its long-session change was −8.5%, no measurable difference.
  • Best for: review-heavy workflows. See Tokenade vs code-review-graph.

6. claude-context — search by meaning, with infrastructure

claude-context is the serena alternative if you want to find code by what it does rather than by its symbol name, and you already run the infrastructure.

  • What it is: an MCP server from Zilliz doing hybrid search (BM25 keyword plus dense vectors) over your code. MIT.
  • Strengths: dense search finds code whose names don't match the question, something neither serena nor a parsed graph can do. Its README reports about 40% token reduction at equivalent retrieval quality, in its own controlled evaluation of retrieval.
  • Limitations: setup needs a vector database (Milvus or Zilliz Cloud) and an embedding API key, OpenAI in the default config, so "free" carries running costs. No editing. Not in THOL, so not measured.
  • Best for: teams already on vector infrastructure. See Tokenade vs claude-context.

At a glance

ToolMeasured session cost (THOL)How it understands codeSymbol-level editingLicence
Tokenade39% cheaper on long sessionsParsing + on-device searchNoFree, open source (MIT/Apache-2.0)
codegraphNo measurable differenceParsed graph, auto-syncNoMIT
tokensaveNot measuredParsed graphEdit primitivesMIT
CodeGraphContextNot measuredGraph databaseNoMIT
code-review-graphNo measurable differenceTree-sitter map, review-scopedNoMIT
claude-contextNot measuredBM25 + dense vectorsNoMIT + infra costs
serena (baseline)Not measuredLanguage servers (LSP)YesGPL-3.0-or-later (SolidLSP: MIT)
Change in the cost of a long session, compared with the agent on its own
Change in the cost of a long session, compared with the agent on its own
Tokenade
measurably cheaper
-39%
code-review-graph
no measurable difference
-8.5%

7 long tasks (over 200,000 tokens), 70 runs per tool, Claude Code 2.1.206 with Claude Sonnet 4.6. “No measurable difference”: the gap is within the run-to-run noise. serena is not in this campaign. Source: THOL, 2026.

The full table, including codegraph and the tools that don't favour mine, is on the THOL explainer.

Is serena a token saver at all?

Not by design: serena is a precision tool, and any token saving is a by-product of reading a symbol instead of a whole file. Its README calls symbolic editing "much more token-efficient" than typical alternatives, but it publishes no headline savings percentage.

What it publishes instead is an evaluation in which agents run about twenty routine coding tasks and give their own verdict on the tools. That is a reasonable way to judge usefulness. It says nothing about the invoice, and serena's authors don't claim it does.

The invoice is a different problem. In THOL's no-tool runs, nine tokens out of ten in a long session are conversation history re-sent at every step. Better navigation trims the reads that enter that history; it doesn't touch test logs, build output or MCP payloads. That is the gap between a precise session and a cheap one.

What changed in serena 2.0?

Three things matter for this comparison: the licence, a new agent interface, and tighter rules for untrusted repositories.

  • Licence: the application moved to GPL-3.0-or-later, SolidLSP stays MIT, and contributions now require a CLA. The change is not retroactive.
  • REPL interface: a new agent interface that reduces the tool set to a minimum and runs serena operations through a code-execution environment.
  • Security: symbolic links are now ignored in untrusted projects, and the editing tools now apply the same path checks as the other file tools.

None of this changes the core: serena still asks your language servers. If the GPL is a problem for your company, the MIT tools above are the clean exit.

Which one should you choose?

  • You want the bill to go down, on more than one AI agent: Tokenade.
  • You want navigation without language servers, kept in sync: codegraph.
  • You want edit primitives in one native binary: tokensave.
  • You trace call chains across a big codebase: CodeGraphContext.
  • You want to know what a change breaks before review: code-review-graph.
  • You run vector infrastructure already: claude-context.
  • You're staying on serena: reasonable if compiler-grade references and safe renames on a large typed codebase are the point. Nothing here beats it there.

Tokenade is free and open source (MIT/Apache-2.0); install it in two commands.

FAQ

Is serena free?

Yes, the MCP toolkit with the language-server backend is free and open source. The optional JetBrains plugin backend is paid, with a free trial. You still pay for your agent's own model calls.

Is serena still MIT-licensed?

Partly. Since v2.0.0, the Serena application is GPL-3.0-or-later and its SolidLSP layer stays MIT; distributions combining both fall under the GPL. Releases before v2.0.0 remain available under MIT.

Does serena reduce token usage?

It can, when a symbol read replaces a whole-file read, and its README says symbolic editing is more token-efficient. It publishes no session-level figure, and it is not in the published THOL campaign, so its effect on the cost of a whole session is not measured.

Can I use serena and Tokenade together?

Yes, they work on different layers: serena answers symbol questions and edits code through language servers, Tokenade trims what tools return to the agent. Measure your bill before and after rather than trusting either counter.

How do I uninstall serena?

Remove the serena MCP entry from your client's configuration, then remove the tool the way you installed it; with the documented install, that is uv tool uninstall serena-agent.


See also:

FAQ

Cut your AI agent's token bill.

Ranked #1 on the Token-Harness Optimizer Leaderboard. Zero config.

Tokenade cuts the token bill of AI agents: one install, zero config, and it trims what your agent sends to the model.