serena

# Serena - Semantic Code Understanding IDE-like semantic code operations via CLI. Provides symbol-level code navigation, editing, and project memory. ## Prerequisites ```bash pip install serena-agent typer pyyaml ``` ## Quick Start **First-time setup**: Launch the Web Dashboard to initialize and register the project: ```bash python -m tools dashboard serve --open-browser ``` This will: - Initialize Serena configuration - Register the current project in `~/.serena/serena_config.yml` - Open the Web Dashboard for monitoring and configuration **Configuration**: Edit `.env` file in `skills/serena/` directory: ```bash SERENA_CONTEXT=claude-code SERENA_MODES=interactive,editing,onboarding SERENA_PROJECT=. ``` ## Usage ### Basic Command Structure ```bash python -m tools [GLOBAL OPTIONS] <command> [COMMAND OPTIONS] ``` **Global Options** (must be specified before the command): - `-p, --project PATH` - Project directory (default: current directory, env: SERENA_PROJECT) - `-c, --context TEXT` - Execution context (auto-detected if not specified, env: SERENA_CONTEXT) - `-m, --mode TEXT` - Operation modes (can be specified multiple times, env: SERENA_MODES) ### Working with Different Projects **Important**: When working with projects in different locations (especially cross-drive on Windows), use `--project`: ```bash # Correct: Use --project for different project locations python -m tools --project "/path/to/project" symbol find MyClass python -m tools --project "E:\MyProjec...