name        = "serena"
description = "Symbol-aware coding agent toolkit (MCP server) — semantic find/edit/refactor"
homepage    = "https://github.com/oraios/serena"
tools       = ["claude"]
scope       = "global"
update      = "uv tool upgrade serena-agent"
uninstall   = "claude mcp remove --scope user serena 2>/dev/null || true; uv tool uninstall serena-agent 2>/dev/null || true"

[[artifacts]]
kind = "cli"
name = "serena"

[[prereq]]
name  = "uv"
check = "command -v uv"

[prereq.install]
brew   = "uv"
pacman = "uv"
paru   = "uv"
yay    = "uv"

[[prereq]]
name  = "claude"
check = "command -v claude"

[[install]]
id      = "uv-tool"
label   = "uv tool install + register Serena MCP with Claude Code (user scope)"
command = "uv tool install -p 3.13 serena-agent && claude mcp add --scope user serena -- serena start-mcp-server --context claude-code --project-from-cwd"

[[instructions]]
content = """
Serena exposes symbol-level coding tools as an MCP server: find/rename
symbols, list references, structural edits across files. Prefer Serena's
MCP tools over plain text search/edit for symbol-aware operations and
multi-file refactors. The active project is taken from the current
working directory (`--project-from-cwd`).
"""
