codebase-memory-mcp

Indexes codebases into a queryable knowledge graph via an MCP server.

Updated Jul 24, 2026
One-click install
npx skills add https://github.com/gweone/agent-plugins --skill codebase-memory-mcp-gweone
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codebase-memory-mcp
Source: https://github.com/gweone/agent-plugins/tree/main/plugin/sharpps-work/skills/codebase-memory-mcp
Command: npx skills add https://github.com/gweone/agent-plugins --skill codebase-memory-mcp-gweone

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Understanding a large or polyglot codebase with grep-based exploration is slow and misses cross-service relationships. This Skill turns any codebase into a persistent knowledge graph so you can ask architecture, call-graph, and impact-analysis questions in plain English instead of manually tracing files. ## Core Features & Use Cases - Knowledge graph indexing: Parses 158 languages with tree-sitter plus semantic type resolution, exposing 15 MCP tools (index_repository, search_graph, trace_path, detect_changes, query_graph, get_architecture, and more) with CLI equivalents for scripting. - Cross-service route tracing: Matches HTTP routes to call sites with confidence scoring, plus gRPC/GraphQL/tRPC/Socket.IO detection, so a frontend fetch() call can link to the backend controller that serves it. - Staleness and verification guidance: Detects when uncommitted edits leave the graph stale (auto-watch is git-commit based, not filesystem based) and verifies graph answers before trusting them. - Use Case: Before modifying a shared API endpoint, ask the agent to trace every caller across your microservices and run detect_changes on your diff to see which symbols are affected and their risk classification. ## Quick Start Ask the agent to install codebase-memory-mcp with its one-line install script, restart the session, then say "index this project" and start asking architecture questions in plain English.

Frequently Asked Questions about codebase-memory-mcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I index a codebase into a knowledge graph?

Run the one-line install script to fetch the codebase-memory-mcp binary and register it with your agent, restart the session, then ask the agent to index the project. The agent calls the index_repository MCP tool, or you can run codebase-memory-mcp cli index_repository --repo-path directly.

How do I trace HTTP calls across microservices?

Use the trace_path or search_graph MCP tools, which match HTTP routes to call sites with confidence scoring across languages. A frontend fetch('/api/orders') call can link to the backend controller serving it, something per-language call-graph tools cannot do.

What languages does codebase-memory-mcp support?

It parses 158 languages via vendored tree-sitter grammars in quality tiers. Full hybrid semantic resolution covers Python, TypeScript/JavaScript, PHP, C#, Go, C, C++, Java, Kotlin, Rust, and Perl; check the tier list before relying on results for unusual languages.

Why is my codebase knowledge graph showing stale results?

The auto-watch feature is git-commit based, not filesystem based, so uncommitted edits do not trigger reindexing. Run git status --porcelain on the indexed root before trusting an answer, and re-index if uncommitted changes exist.

Can I use codebase-memory-mcp without an MCP client?

Yes, the cli subcommand (e.g. codebase-memory-mcp cli search_graph, cli trace_path, cli query_graph) runs one-shot queries without starting the daemon or needing an MCP client. This is the required mode for remote shell or sandboxed connections.

Does the install script work in auto-mode agent sessions?

No, auto-mode permission classifiers block curl-piped install scripts as fetching and executing an external binary, and this cannot be worked around from inside the session. Print the commands and ask the user to run them in their own terminal instead.