Dianel555/DSkills / skills/serena
serena
VerifiedSemantic code understanding with IDE-like symbol operations. Use when: (1) Large codebase analysis (>50 files), (2) Symbol-level operations (find, rename, refactor), (3) Cross-file reference tracking, (4) Project memory and session persistence, (5) Multi-language semantic navigation. Triggers: "find symbol", "rename function", "find references", "symbol overview", "project memory". IMPORTANT: Prioritize Serena's symbolic tools over file-based grep/read for code exploration.
| File | Kind | Size |
|---|---|---|
| .env.example | other | 619 B |
| README.md | markdown | 6.8 KB |
| SKILL.md | skill md | 7.1 KB |
| tools/__init__.py | script | 310 B |
| tools/__main__.py | script | 94 B |
| tools/cli/__init__.py | script | 3.4 KB |
| tools/cli/cmd.py | script | 1.0 KB |
| tools/cli/config.py | script | 1.1 KB |
| tools/cli/dashboard.py | script | 5.3 KB |
| tools/cli/file.py | script | 1.4 KB |
| tools/cli/memory.py | script | 1.5 KB |
| tools/cli/symbol.py | script | 3.7 KB |
| tools/cli/workflow.py | script | 780 B |
| tools/core.py | script | 7.8 KB |
| tools/extended/__init__.py | script | 30 B |
| tools/extended/cmd_tools.py | script | 3.7 KB |
| tools/extended/config_tools.py | script | 4.9 KB |
| tools/output.py | script | 402 B |
| tools/paths.py | script | 1.5 KB |
| tools/server/__init__.py | script | 110 B |
| tools/server/dashboard_server.py | script | 14.1 KB |
| tools/tests/__init__.py | script | 30 B |
| tools/tests/conftest.py | script | 256 B |
| tools/tests/test_cli_dashboard.py | script | 3.0 KB |
| tools/tests/test_cli_file.py | script | 3.4 KB |
| tools/tests/test_cli_memory.py | script | 2.6 KB |
| tools/tests/test_core.py | script | 5.4 KB |
| tools/tests/test_module_path.py | script | 3.0 KB |
| tools/tests/test_paths.py | script | 2.8 KB |
tools/cli/__init__.py
View on GitHub"""CLI package for Serena tools using Typer."""
import os
import typer
from typing import Optional, List
from pathlib import Path
# Load .env file if it exists
def _load_dotenv():
"""Load environment variables from .env file."""
try:
from dotenv import load_dotenv
# Try multiple locations
env_paths = [
Path(__file__).parent.parent / ".env", # skills/serena/tools/.env
Path(__file__).parent.parent.parent / ".env", # skills/serena/.env
Path.cwd() / ".env", # current directory
]
for env_path in env_paths:
if env_path.exists():
load_dotenv(env_path, override=False)
return
except ImportError:
# python-dotenv not installed, skip
pass
_load_dotenv()
app = typer.Typer(
name="serena",
help="Semantic code operations with IDE-like symbol navigation",
no_args_is_help=True,
)
class State:
"""Global state for sharing SerenaCore instance across commands."""
core: Optional["SerenaCore"] = None
@app.callback()
def main(
ctx: typer.Context,
project: str = typer.Option(
".",
"-p",
"--project",
envvar="SERENA_PROJECT",
help="Project directory path",
),
context: Optional[str] = typer.Option(
None,
"-c",
"--context",
envvar="SERENA_CONTEXT",
help="Execution context (agent, claude-code, ide, codex). Auto-detected if not specified.",
),
mode: Optional[List[str]] = typer.Option(
None,
"-m",
"--mode",
help="Operation modes (can be specified multiple times)",
),
):
"""
Initialize SerenaCore with global options.
All commands inherit these global options and share the same SerenaCore instance.
"""
from ..core import SerenaCore
from ..extended.cmd_tools import RunCommandTool, RunScriptTool
from ..extended.config_tools import ReadConfigTool, UpdateConfigTool
from ..output import output_error
try:
# Initialize SerenaCore with global options
# Read modes from environment variable if not provided via CLI
if mode is None:
import os
env_modes = os.environ.get("SERENA_MODES")
if env_modes:
modes = [m.strip() for m in env_modes.split(",")]
else:
modes = ["interactive", "editing"]
else:
modes = mode
State.core = SerenaCore(project=project, context=context, modes=modes)
# Register extended tools
State.core.register_tool(RunCommandTool())
State.core.register_tool(RunScriptTool())
State.core.register_tool(ReadConfigTool())
State.core.register_tool(UpdateConfigTool())
except Exception as e:
output_error("INIT_FAILED", str(e))
# Command groups will be registered here
from .symbol import app as symbol_app
from .memory import app as memory_app
from .file import app as file_app
from .workflow import app as workflow_app
from .cmd import app as cmd_app
from .config import app as config_app
from .dashboard import app as dashboard_app
app.add_typer(symbol_app, name="symbol")
app.add_typer(memory_app, name="memory")
app.add_typer(file_app, name="file")
app.add_typer(workflow_app, name="workflow")
app.add_typer(cmd_app, name="cmd")
app.add_typer(config_app, name="config")
app.add_typer(dashboard_app, name="dashboard")
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |