How oraios/serena works
Serena is an MCP-based IDE capability layer for coding agents: an agent invokes tools to retrieve, edit, refactor, or debug project code, with semantic analysis supplied by either SolidLSP language servers or the JetBrains plugin. Project configuration and project services establish the workspace; tools also expose REPL workflows and persistent memories. The README documents the capabilities and backend choices; source-index references support the internal links shown here, but several runtime implementations were not sampled.
Main entry points: project.py Project services · ls_manager.py Language server manager · ls.py SolidLSP client · tools Agent tools
Components 20
Agent interface
- MCP server
src/serena/mcp.py - Agent tools
src/serena/tools - REPL interface
src/serena/repl/facade.py
Project services
- Serena config
src/serena/config/serena_config.py - Project services
src/serena/project.py - Project query tools
src/serena/tools/query_project_tools.py - Code editing
src/serena/code_editor.py
Semantic backends
- Language server manager
src/serena/ls_manager.py - SolidLSP client
src/solidlsp/ls.py - Server registry
src/solidlsp/ls_config.py - Language adapters
src/solidlsp/language_servers - Server processes
src/solidlsp/ls_process.py - LSP protocol
src/solidlsp/lsp_protocol_handler/server.py - JetBrains client
src/serena/jetbrains/jetbrains_plugin_client.py
Memory and diagnostics
- Memory manager
src/serena/memories/memory_manager.py - File system
src/serena/util/file_system.py - Dashboard
src/serena/dashboard/dashboard_viewer.py
Other components
- Coding agent
- JetBrains plugin
- Language servers
Connections 21
- Coding agent → MCP server: connects via MCP
- MCP server → Agent tools: exposes tools
- Coding agent → Agent tools: invokes
- Agent tools → Project services: queries project
- Project query tools → JetBrains client: queries symbols
src/serena/tools/query_project_tools.py - Project query tools → Project services: routes queries
src/serena/tools/query_project_tools.py - Project services → Serena config: uses settings
src/serena/project.py - Project services → Language server manager: manages servers
src/serena/project.py - Project services → Memory manager: uses memories
src/serena/project.py - Project services → Code editing: supports edits
- Language server manager → SolidLSP client: starts servers
src/serena/ls_manager.py - Language server manager → Server registry: uses registry
src/serena/ls_manager.py - SolidLSP client → Server registry: uses configuration
src/solidlsp/ls.py - Server registry → Language adapters: registers adapters
src/solidlsp/ls_config.py - SolidLSP client → Server processes: manages process
src/solidlsp/ls.py - Server processes → LSP protocol: uses protocol
src/solidlsp/ls_process.py - Language adapters → Language servers: launches
- JetBrains client → JetBrains plugin: calls plugin API
src/serena/jetbrains/jetbrains_plugin_client.py - Memory manager → File system: reads and writes
src/serena/memories/memory_manager.py - REPL interface → Coding agent: offers execution interface
- Project services → Dashboard: serves project status