What do you want to do?
3 use cases
-
Give your coding agent IDE-level code navigation
Install Serena and connect it over MCP so your agent finds symbols and references instead of grepping files.
View prompt
Install oraios/serena with `uv tool install -p 3.13 serena-agent`, run serena init, and connect it to my <MCP client> as an MCP server. Then use its find symbol and find referencing symbols tools to map how <function or class> is used across this repo.
-
Rename a symbol across a codebase in one call
Use Serena's refactoring tools so a cross-file rename is one atomic call rather than many search and replace edits.
View prompt
Using oraios/serena's refactoring tools, rename <old symbol> to <new symbol> across this project, then safe delete <unused symbol>. List every file that changed and run the tests.
-
Tune Serena's tools and memory per project
Use Serena's layered YAML configuration and memory system to fit each repository and client.
View prompt
Configure oraios/serena for this repository: per-project configuration with only the retrieval and symbolic editing tools active for <client>, the memory system on, and a short note in AGENTS.md on how agents should use Serena memories.
Quick start with Serena
- Check you have what it needs: uv, the only required prerequisite; An MCP client such as Claude Code, Codex, OpenCode, Gemini-CLI, Cursor, VS Code or a JetBrains assistant; An LLM to drive the tools, since Serena itself does no reasoning.
- Open oraios/serena on GitHub and read the README and license.
- Install uv, then run
uv tool install -p 3.13 serena-agent - Check that the Serena command is available, then run Serena init to initialise and verify the setup
- Do not install Serena from an MCP or plugin marketplace; the README warns those commands are outdated
- Connect it to your client either with a launch command or by starting Serena in HTTP mode and giving the client the URL
These steps come from our top use case, Give your coding agent IDE-level code navigation, which also has a copy-paste agent prompt.
Use this in your AI agent
Ask your agent
Using the Deduped MCP, get the setup steps for oraios/serena
Add Deduped to Claude Code once
claude mcp add --transport http deduped https://dedupedai.com/mcp
Every Monday: the 5 hottest repos and exactly how to use them. Free, one email a week, unsubscribe anytime.
Get them freeAbout this repo
- Who it is forDevelopers using Claude Code, Codex, Cursor, Gemini CLI or other MCP clients on large codebases where text search and line edits get fragile.
- Why it is hot31k stars, talked about in 2 AI sources we track
- LanguagePython
- Sourcegithub.com/oraios/serena ยท Back to Hot repos
Requirements
- uv, the only required prerequisite
- An MCP client such as Claude Code, Codex, OpenCode, Gemini-CLI, Cursor, VS Code or a JetBrains assistant
- An LLM to drive the tools, since Serena itself does no reasoning
- For some languages, extra language server dependencies listed on the Language Support page
- Optional: the paid Serena JetBrains Plugin (free trial) for move, inline and debugging
Add this badge to your README
Maintain Serena? Show readers where to find these use cases.
Markdown
[](https://dedupedai.com/use-cases/oraios-serena/?utm_source=github&utm_medium=badge&utm_campaign=oraios-serena)
HTML
<a href="https://dedupedai.com/use-cases/oraios-serena/?utm_source=github&utm_medium=badge&utm_campaign=oraios-serena"><img src="https://dedupedai.com/badge/oraios/serena.svg" alt="Use cases on Deduped" height="20"></a>
A static image, no tracking script. About the badge
Questions about Serena
What is Serena?
Serena is an MCP server that gives coding agents IDE-like tools: semantic code retrieval, symbolic editing, refactoring and debugging that work at the symbol level instead of line numbers and text search. It runs on language servers for over 40 programming languages by default, or on a paid JetBrains plugin for extra refactoring and interactive debugging, and adds a memory system and YAML configuration for long-lived agent workflows. It is an open-source project on GitHub: https://github.com/oraios/serena.
How do I use Serena?
Install uv, then run uv tool install -p 3.13 serena-agent; then check that the Serena command is available, then run Serena init to initialise and verify the setup; Do not install Serena from an MCP or plugin marketplace; the README warns those commands are outdated. The use cases on this page give the full steps and a copy-paste agent prompt for each job.
Who is Serena for?
Developers using Claude Code, Codex, Cursor, Gemini CLI or other MCP clients on large codebases where text search and line edits get fragile.
What can I do with Serena?
3 use cases so far, for example: Give your coding agent IDE-level code navigation; Rename a symbol across a codebase in one call; Tune Serena's tools and memory per project. Each has steps and a copy-paste agent prompt.
What do I need to run Serena?
uv, the only required prerequisite; An MCP client such as Claude Code, Codex, OpenCode, Gemini-CLI, Cursor, VS Code or a JetBrains assistant; An LLM to drive the tools, since Serena itself does no reasoning; For some languages, extra language server dependencies listed on the Language Support page.
What are alternatives to Serena?
Other hot AI repos in Software and DevOps: Deep Infer, Thinkrail, ECC, Instructor, Aider.
Is Serena safe to run?
Deduped does not own, audit or vouch for it. Read the README and license, run it on your own systems first and review every command before you run it.