makabakaxy serena (via mcp2cli)
Code-aware editing, symbol navigation, memory, and project management.
Shortcuts
No shortcuts configured. Use mcp2cli serena <group> <cmd>.
Commands
File
| Command | Description | Example | Ref |
|---|---|---|---|
mcp2cli serena file create |
Create or overwrite a text file | mcp2cli serena file create --relative-path src/new.py --content 'print("hi")' |
ref |
mcp2cli serena file get |
Read a file or chunk | mcp2cli serena file get --relative-path src/main.pymcp2cli serena file get --relative-path src/main.py --start-line 10 --end-line 50 |
ref |
mcp2cli serena file search |
Search regex pattern across codebase | mcp2cli serena file search --substring-pattern 'def my_func' |
ref |
mcp2cli serena file list |
List files in a directory | mcp2cli serena file list --relative-path . --recursive false |
ref |
mcp2cli serena file find |
Find files by name mask | mcp2cli serena file find --file-mask '*.py' --relative-path src |
ref |
mcp2cli serena file replace |
Replace pattern occurrences in a file | ref |
Symbol
| Command | Description | Example | Ref |
|---|---|---|---|
mcp2cli serena symbol find |
Find symbols by name path pattern | mcp2cli serena symbol find --name-path-pattern MyClass/my_method |
ref |
mcp2cli serena symbol overview |
Get high-level symbol overview of a file | mcp2cli serena symbol overview --relative-path src/main.py |
ref |
mcp2cli serena symbol replace |
Replace the body of a symbol | ref | |
mcp2cli serena symbol insert-after |
Insert content after a symbol | ref | |
mcp2cli serena symbol insert-before |
Insert content before a symbol | ref | |
mcp2cli serena symbol rename |
Rename a symbol codebase-wide | ref | |
mcp2cli serena symbol refs |
Find symbols referencing a symbol | ref | |
mcp2cli serena symbol delete |
Delete a symbol if unreferenced | ref |
Memory
| Command | Description | Example | Ref |
|---|---|---|---|
mcp2cli serena memory write |
Write project info to named memory | mcp2cli serena memory write --memory-name 'auth/logic' --content 'Auth uses JWT' |
ref |
mcp2cli serena memory get |
Read a memory | mcp2cli serena memory get --memory-name 'auth/logic' |
ref |
mcp2cli serena memory list |
List available memories | mcp2cli serena memory list |
ref |
mcp2cli serena memory update |
Edit memory via pattern replacement | ref | |
mcp2cli serena memory rename |
Rename or move a memory | ref | |
mcp2cli serena memory delete |
Delete a memory | ref |
Shell / Project / Session
| Command | Description | Example | Ref |
|---|---|---|---|
mcp2cli serena shell |
Execute a shell command | mcp2cli serena shell --command 'npm test' |
ref |
mcp2cli serena project activate |
Activate a project by name or path | mcp2cli serena project activate --project my-project |
ref |
mcp2cli serena project onboarding |
Perform project onboarding | ref | |
mcp2cli serena session config |
Get current agent configuration | ref | |
mcp2cli serena session modes |
Switch active agent modes | mcp2cli serena session modes --modes '["editing","interactive"]' |
ref |
mcp2cli serena session instructions |
Get Serena Instructions Manual | ref |
Discover Parameters
Append --help to any command for full parameter list:
mcp2cli serena file get --help
Note: Use Ref links in the Commands table above to view detailed parameter reference and more examples.
User Notes
MUST READ users/skill.md for custom workflows and tips. Config: MCP server settings live in
~/.agents/mcp2cli/servers.yaml- edit there to take effect.