Give your AI agent a knowledge graph of your codebase
A self-hosted MCP daemon that indexes your code into a structural graph —
search_graph, trace_call_path, get_architecture —
so agents like Claude Code stop grepping and start reasoning. No embeddings required.
The agent is the intelligence. NexusContext is the memory.
No LLM lives in the daemon. It builds structure and answers queries — your agent still does all the reasoning.
Knowledge graph, not just vectors
Tree-sitter parses Rust & Python into a SQLite graph of functions, types, and call edges — structural queries that need zero embeddings.
MCP-native
A real JSON-RPC 2.0 stdio server with 9 tools, verified against real IDE-style sessions — drop it into any MCP-compatible agent.
Desktop-first on Linux
A native GTK4 + libadwaita manager app and a thin GNOME Shell status indicator — not a web dashboard bolted on afterward.
Safe by default
Embeddings endpoints are blocked unless loopback/private or explicitly allowed. Indexing can be scoped to an allowlist. Opt-in, not implicit.
Team-shareable index
Export a compressed graph snapshot next to your source so teammates skip the first reindex on clone — never committed unless you choose to.
Obsidian-ready export
Turn the call graph into a folder of markdown files with [[wikilinks]] — browse your codebase's structure in a vault, for free.
One daemon, two transports, three clients
stdio is reserved for MCP agents; a Unix socket serves the GUI and Shell extension — they never compete for the same pipe.
┌──────────────────────────────┐ MCP clients ──────► nexusd mcp (stdio, per-session) │ (Claude Code, etc.) │ listTools / callTool │ │ search_graph · trace_call_path│ │ get_architecture · query_planner│ └──────────────────────────────┘ │ ▼ shared SQLite graph.db (WAL mode) ▲ ┌──────────────────────────────┐ GUI + Shell ext ──► nexusd serve (Unix socket, systemd)│ │ status · projects · config │ │ search.adhoc · reindex │ └──────────────────────────────┘
Install, index, ask
# build & package cargo build --release cargo deb -p nexusd --no-build sudo dpkg -i target/debian/nexuscontext_*.deb # run the daemon persistently systemctl --user enable --now nexuscontext.service # index a project and query it nexus reindex /path/to/your/project nexus search-graph SomeFunction --project /path/to/your/project # register with Claude Code claude mcp add -s user nexuscontext -- nexusd mcp
Full walkthrough — GUI, GNOME extension, config, packaging — in INSTALL.md.
Every phase of the roadmap, shipped
Each one verified end-to-end against the real running system, not just cargo build.