Codebase Memory MCP

Summary

Ring runs DeusData codebase-memory-mcp 0.11.0 from the single binary /Users/insight/code/ringdom/AI-RING/codebase-memory-mcp. Cursor, Claude, OpenCode, and VS Code launch that path. The live process is one MCP parent plus a child --cbm-daemon-internal. Server id user-codebase-memory-mcp. Layer1 project Users-insight-code-ringdom-ring-web at /Users/insight/code/ringdom/ring/web. Call list_projects before inventing an id. CLI prefers flags, --args-file, or stdin. A raw JSON argument still runs and prints a deprecation warning. Default CLI output is a compact tree. --json returns the MCP envelope and --format json returns the payload. Drop level= lines. Docs loop: legiox-knowledge, then this graph, then rg on lib/, app/api/, env.local.template, and data/schema.sql. search_code finds text (regex true for alternation, mode compact by default). search_graph then get_code_snippet or get_file_outline. trace_path needs the exact function name. check_index_coverage shows whether a path is in the index. compare_graphs diffs two indexed projects. detect_changes requires project plus an optional since. Route wiring is search_graph with label Route. The 0.11.0 index keeps file extensions on File qualified names, so the first index_repository after this upgrade is a full rebuild and ADRs are kept. An over-budget index fails with reason over_memory_budget and leaves the previous index. Raise CBM_MEM_BUDGET_MB. A daemon that cannot start names stage, errno, and path. After a CLI reindex, restart the MCP server so its cache matches disk. If the graph and rg disagree, trust rg.

Instructions

1. list_projects before any project id. Layer1 id is Users-insight-code-ringdom-ring-web for /Users/insight/code/ringdom/ring/web.
2. Existence: search_code {"pattern":"DatabaseService","project":"Users-insight-code-ringdom-ring-web","limit":10}. Alternation foo|bar needs regex true.
3. Symbol: search_graph name_pattern ".getSharedPgPool." then get_code_snippet on the qualified_name.
4. Callers: trace_path {"function_name":"…","direction":"inbound","depth":3}. Outbound uses direction outbound. Exact name only.
5. Routes: search_graph name_pattern ".Route." with label Route. HTTP edges: query_graph MATCH (a)-[r:HTTP_CALLS]->(b) RETURN … LIMIT 20.
6. Architecture: get_architecture {"aspects":["all"]}. Changes: detect_changes {"since":"YYYY-MM-DD"} or a git ref.
7. CLI: /Users/insight/code/ringdom/AI-RING/codebase-memory-mcp cli --quiet <tool> --project <id> --flag value. Prefer flags, --args-file, or stdin. Raw JSON still works and warns. --json for the MCP envelope. --format json for the payload.
8. File outline: get_file_outline --project Users-insight-code-ringdom-ring-web --file-path app/api/store/products/route.ts.
9. Coverage: check_index_coverage --project <id> --paths '["lib/database"]' before claiming a path is absent from the graph.
10. Two trees: compare_graphs --base-project Users-insight-code-ringdom-ring-web --target-project <other indexed id>.
11. detect_changes requires --project. Optional --since YYYY-MM-DD, --scope impact|files, --direction inbound|outbound|both.
12. Stale index: DB mtime over 3 days or today's commits missing. index_repository --repo-path /Users/insight/code/ringdom/ring/web --mode full, then restart MCP. The first run after 0.11.0 is a full rebuild because File qualified names now keep their extension. ADRs survive.
13. Over budget: reason over_memory_budget, previous index preserved. Raise CBM_MEM_BUDGET_MB. A .stage.*.lock sidecar exists only while an index runs.
14. Daemon start failure names stage, errno, and path. One binary only. Do not install a second copy under ~/.local/bin.
15. Dead-code or fan-in: search_graph with max_degree or min_degree. Useful for deprecated callouts, not for prose.

Deeper fields

jq -r '.mission, .expertise, .keywords' "mcp/AI-LEGIOX/legiox-truth-lens/codebase-memory-mcp.nodus.json"