Serena

# Serena Repository Structure ## Overview Serena is a multi-language code assistant that combines two main components: 1. **Serena Core** - The main agent framework with tools and MCP server 2. **SolidLSP** - A unified Language Server Protocol wrapper for multiple programming languages ## Top-Level Structure ``` serena/ ├── src/ # Main source code │ ├── serena/ # Serena agent framework │ ├── solidlsp/ # LSP wrapper library │ └── interprompt/ # Multi-language prompt templates ├── test/ # Test suites │ ├── serena/ # Serena agent tests │ ├── solidlsp/ # Language server tests │ └── resources/repos/ # Test repositories for each language ├── scripts/ # Build and utility scripts ├── resources/ # Static resources and configurations ├── pyproject.toml # Python project configuration ├── README.md # Project documentation └── CHANGELOG.md # Version history ``` ## Source Code Organization ### Serena Core (`src/serena/`) - **`agent.py`** - Main SerenaAgent class that orchestrates everything - **`tools/`** - MCP tools for file operations, symbols, memory, etc. - `file_tools.py` - File system operations (read, write, search) - `symbol_tools.py` - Symbol-based code operations (find, edit) - `memory_tools.py` - Knowledge persistence and retrieval - `config_tools.py` - Project and mode management - `workflow_tools.py` - Onboarding and meta-operations - **`config/`** - Configuration management - `serena_config.py` - Main configuration classes - `context_mode.py` - Context and mode definitions - **`util/`** - Utility modules - **`mcp.py`** - MCP server implementation - **`cli.py`** - Command-line interface ### SolidLSP (`src/solidlsp/`) - **`ls.py`** - Main SolidLanguageServer class - **`language_servers/`** - Language-specific implementations - `csharp_language_server.py` - C# (Microsoft.CodeAnalysis.LanguageServer) - `python_server.py` - Python (Pyright) - `typescript_language_server.py` - TypeScript - `rust_analyzer.py` - Rust - `gopls.py` - Go - And many more... - **`ls_config.py`** - Language server configuration - **`ls_types.py`** - LSP type definitions - **`ls_utils.py`** - Utilities for working with LSP data ### Interprompt (`src/interprompt/`) - Multi-language prompt template system - Jinja2-based templating with language fallbacks ## Test Structure ### Language Server Tests (`test/solidlsp/`) Each language has its own test directory: ``` test/solidlsp/ ├── csharp/ │ └── test_csharp_basic.py ├── python/ │ └── test_python_basic.py ├── typescript/ │ └── test_typescript_basic.py └── ... ``` ### Test Resources (`test/resources/repos/`) Contains minimal test projects for each language: ``` test/resources/repos/ ├── csharp/test_repo/ │ ├── serena.sln │ ├── TestProject.csproj │ ├── Program.cs │ └── Models/Person.cs ├── python/test_repo/ ├── typescript/test_repo/ └── ... ``` ### Test Infrastructure - **`test/conftest.py`** - Shared test fixtures and utilities - **`create_ls()`** function - Creates language server instances for testing - **`language_server` fixture** - Parametrized fixture for multi-language tests ## Key Configuration Files - **`pyproject.toml`** - Python dependencies, build config, and tool settings - **`.serena/`** directories - Project-specific Serena configuration and memories - **`CLAUDE.md`** - Instructions for AI assistants working on the project ## Dependencies Management The project uses modern Python tooling: - **uv** for fast dependency resolution and virtual environments - **pytest** for testing with language-specific markers (`@pytest.mark.csharp`) - **ruff** for linting and formatting - **mypy** for type checking ## Build and Development - **Docker support** - Full containerized development environment - **GitHub Actions** - CI/CD with language server testing - **Development scripts** in `scripts/` directory