LibreAI / Dev Tools / serena
// devtools · oraios/serena

serena

An MCP toolkit that gives coding agents IDE-grade semantic retrieval, editing and refactoring

★ 30.1k stars⑂ 2.0k forksGPL-3.0updated 2026-10
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

serena is an open-source dev tools project by oraios (oraios/serena on GitHub). It has 30,105 GitHub stars and 2,048 forks, is released under the GPL-3.0 license, and was last updated on GitHub on 8 October 2026.

Repository
oraios/serena
GitHub stars
30,105
Forks
2,048
License
GPL-3.0
Last updated on GitHub
8 October 2026
Category
Dev Tools
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Decide what you want to achieve with serena and check the README on GitHub for requirements before installing.

  2. Get the code

    Clone the repository from GitHub (or take the packaged install route in step 3 if the README offers one).

  3. Install and configure

    Follow the project's documented install commands — the Run section below lists the exact ones — and add any required API keys or models.

  4. Run your first task

    Work through the README's quickstart example end to end, then adapt it to your own project or data.

// features

Why people love it

Semantic retrieval

Find symbols, references and implementations through language-server intelligence rather than grep.

Symbolic editing

Edit code at the symbol level — replace or insert bodies of functions and classes reliably.

Refactoring support

Rename and move symbols with the language server keeping references consistent.

Interactive debugging

Includes interactive debugging capabilities for agent-driven investigation.

Memory management

Project memories persist useful context across agent sessions.

Highly configurable

Configurable per project and language, supporting many programming languages via their language servers.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the Serena source and documentation.

    git clone https://github.com/oraios/serena.git
    cd serena
  2. Install Serena with uv

    Serena's only prerequisite is uv; install the tool as documented.

    uv tool install -p 3.13 serena-agent
  3. Add it to your MCP client

    Register Serena as an MCP server in Claude Code, Codex or your client per the user guide, then open a project and let the agent explore it symbolically.

    # see the Quick Start / User Guide in the README for your client's exact config
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains serena?

serena is maintained by the oraios organization/account on GitHub, together with open-source contributors, in the public repository oraios/serena.

Is serena free to use?

Yes — the code is open source under the GPL-3.0 license. You can use, modify and redistribute it under that license's terms.

Does serena need a paid API key?

Serena itself is free and open source; it enhances an existing coding agent, so you still need that agent's own model access (subscription or API key).

How does serena compare to plain grep/RAG code search?

Text search misses semantic relationships; Serena's language-server backbone gives agents the same find-references and rename powers a human gets in an IDE.

How do I get started with serena?

Clone the repository from GitHub, follow the install commands in the Run section (taken from the project's README), and complete the documented quickstart example before adapting it to your own use case.

// keep exploring

Similar tools

Dev Tools

SocratiCode

Enterprise-grade codebase intelligence for AI agents — hybrid semantic search over 40M+ LOC, locally.

★ 3.3k starsAGPL-3.0
View guide →
Dev Tools

superset

Agentic IDE that runs 100+ parallel coding agents in isolated workspaces on your own subscriptions.

★ 15.0k starsElastic License 2.0
View guide →
Dev Tools

cocoindex-code

Lightweight AST-based semantic code search CLI (ccc) that makes coding agents faster and cheaper

★ 2.8k starsApache-2.0
View guide →
Dev Tools

mcp_agent_mail

Gmail for coding agents: identities, inboxes, threads, and file leases over FastMCP, Git, and SQLite.

★ 2.2k starsNOASSERTION
View guide →
Dev Tools

opcode

A desktop GUI and toolkit for Claude Code - agents, sessions, analytics and MCP

★ 22.4k starsAGPL-3.0
View guide →
Dev Tools

wigolo

Local-first web search, fetch, crawl and research for AI coding agents over MCP — no API keys.

★ 5.5k starsAGPL-3.0
View guide →
// alternatives

Alternatives in Dev Tools

The most-starred other Dev Tools projects in the LibreAI catalogue — the realistic shortlist if serena is not the right fit.

Get serena

Free and open — grab the source, star the repo, and start creating.