serena
oraios/serena · Updated
A powerful MCP toolkit for coding, providing semantic retrieval and editing capabilities - the IDE for your agent
oraios/serena is a Python repository in the AI Agents category with 30,841 stars and 2,102 forks on GitHub, last updated yesterday.
How to install serena in your AI client
Setup for Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline and VS Code — copy-paste ready.
How to install serena in Claude CodeAnthropic's agentic CLI
Clone & open
bashgit clone https://github.com/oraios/serena.git cd serena claudeLet Claude read it
Ask “/init” to generate a CLAUDE.md, then have Claude explain, run, or extend the codebase. It reads files on demand.
How to install serena in Claude DesktopDesktop app (MCP config)
Clone the repository
bashgit clone https://github.com/oraios/serena.gitOpen in your AI editor
Open the folder in your assistant and ask it to index the codebase, then reference files in chat.
How to install serena in CursorAI-first code editor
Clone & open in Cursor
bashgit clone https://github.com/oraios/serena.gitIndex & chat
Open the folder — Cursor indexes it automatically. Use @Codebase in chat to ask about it or scaffold from it.
How to install serena in Codex CLIOpenAI coding agent
Clone
bashgit clone https://github.com/oraios/serena.gitPoint Codex at it
Run codex in the repo root; add setup notes to AGENTS.md so the agent knows how to build & test.
How to install serena in WindsurfCodeium's agentic IDE
Clone & open
bashgit clone https://github.com/oraios/serena.gitUse Cascade
Windsurf indexes the workspace; ask Cascade to explain or reuse modules from the repo.
How to install serena in ClineVS Code autonomous agent
Clone the repository
bashgit clone https://github.com/oraios/serena.gitOpen in your AI editor
Open the folder in your assistant and ask it to index the codebase, then reference files in chat.
How to install serena in VS CodeCopilot / MCP support
Clone the repository
bashgit clone https://github.com/oraios/serena.gitOpen in your AI editor
Open the folder in your assistant and ask it to index the codebase, then reference files in chat.
Documentation
Full READMEThe IDE for Your Coding Agent
- Serena provides essential semantic code retrieval, editing, refactoring and debugging tools that are akin to an IDE's capabilities,
operating at the symbol level and exploiting relational structure.
- It integrates with any client/LLM via the model context protocol (MCP).
Serena's agent-first tool design involves robust high-level abstractions, distinguishing it from approaches that rely on low-level concepts like line numbers or primitive search patterns.
Practically, this means that your agent operates faster, more efficiently and more reliably, especially in larger and more complex codebases.
[!TIP] Serena v2 with the new REPL-based agent interface has been released. Learn more about the new interface and how to configure it.
Video
What Our "End Users" Say
While it is humans who download and set up Serena, our end users are essentially AI agents. As the ones actually applying Serena's tools, they are in the best position to evaluate Serena.
We crafted an unbiased evaluation prompt that leads the agent to perform ~20 routine coding tasks, representative of everyday development work, in order to estimate the value added by Serena's tools when used alongside its own built-ins.
Here's a one-sentence summary of what the agents had to say:
Opus 4.6 (high) in Claude Code on a large Python codebase:
"Serena's IDE-backed semantic tools are the single most impactful addition to my toolkit – cross-file renames, moves, and reference lookups that
Excerpt — the full document is on GitHub.
More AI Agents repositories
- AI Agents265k
deepseek-harness
DeepSeek Harness: Everything is a Plugin.
TypeScriptMITdeepseek-ai/deepseek-harness
- AI Agents258k
hermes-agent
The agent that grows with you
PythonMITNousResearch/hermes-agent
- AI Agents197k
firecrawl
Supercharge your AI agents with data from the web and beyond. Building the library for superintelligence. 🔥
TypeScriptAGPL-3.0firecrawl/firecrawl
- AI Agents180k
ponytail
Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.
JavaScriptMITDietrichGebert/ponytail
- AI Agents149k
langchain
The agent engineering platform.
PythonMITlangchain-ai/langchain
- AI Agents110k
orca
Orca is the place for working with a fleet of agents (e.g. Grok Bot, Claude Code). Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.
TypeScriptMITstablyai/orca
Catalog data refreshed . Something wrong? Report it.