Introduction
LocusGraph is the wisdom graph for AI agents. It doesn't just store what agents learn — it builds structured knowledge that compounds over time.
Agents forget. Every session starts from zero. Every insight gets rediscovered. Every mistake gets repeated. LocusGraph fixes this.
What it does
LocusGraph gives your agent five core operations:
- Store — Save facts, actions, decisions, observations, and feedback as structured knowledge
- Retrieve — Semantic search across stored wisdom with context filtering
- Connect — Link knowledge with
reinforces,contradicts,extends, andrelated_to - Organize — Scope knowledge by context IDs, context types, and graphs
- Reason — Generate insights by reasoning over accumulated wisdom
Every piece of knowledge has a source (agent, user, system, validator, executor), a confidence score, and typed links to other knowledge. This isn't a vector database. It's a wisdom graph.
How agents use it
An agent with LocusGraph remembers across sessions. It tracks which patterns work, which mistakes to avoid, and what the user prefers.
The graduation chain captures this:
mistake → pattern → skillSame error three times? It becomes a mistake. Same workflow across sessions? It becomes a pattern. Pattern used five times successfully? It becomes a skill. The agent grows wiser — permanently.
Integration options
Pick the path that fits your stack:
| Method | Best for |
|---|---|
| MCP Server | Claude, Cursor, Amp, and any MCP-compatible client |
| TypeScript SDK | Node.js agents and LangChain apps |
| Python SDK | Python agents and LangChain apps |
| Rust SDK | Performance-critical and embedded agents |
All paths give you the same five operations. The MCP server is the fastest way to start — no code required, just connect your client.
Core concepts
Before you start building, understand these four ideas:
Events are the atomic unit. Every memory enters LocusGraph as an event — a fact, action, decision, observation, or feedback. Each event has a payload, a source, and optional links.
Contexts organize events. A context ID like skill:react_best_practices or session:20250319_1400_ab3f groups related memories. You filter retrieval by context to get relevant results.
Links create structure. extends builds parent-child trees. reinforces adds confidence. contradicts overrides old information. related_to connects across branches.
Graphs isolate workspaces. Each graph is a separate memory space — use one per project, per team, or per agent.