cortexdb
mcp
Fail
Health Pass
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 261 GitHub stars
Code Fail
- process.env — Environment variable access in clients/node/examples/agent_memory.js
- child_process — Shell command execution capability in clients/node/test/integration.js
- fs.rmSync — Destructive file system operation in clients/node/test/integration.js
- process.env — Environment variable access in clients/node/test/integration.js
- fs module — File system access in clients/node/test/integration.js
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
AI memory and a knowledge graph in one SQLite file. Pure Go: vectors, RAG, agent memory, RDF/SPARQL, Cypher, 80+ MCP tools. Works without an embedding model.
README.md
CortexDB
AI memory and a knowledge graph in one SQLite file. Pure Go, no service to run, works without an embedding model.

Install
| Go library | go get github.com/liliang-cn/cortexdb/v2 |
| Claude Code | /plugin marketplace add liliang-cn/cortexdb, then /plugin install cortexdb@cortexdb |
| Codex | codex plugin marketplace add liliang-cn/cortexdb && codex plugin add cortexdb@cortexdb |
| Shared-brain server | go install github.com/liliang-cn/cortexdb/v2/cmd/cortexdb-grpc@latest |
| Clients | cargo add cortexdb-client · pip install cortexdb-client · npm install cortexdb-client |
Use
db, _ := cortexdb.Open(cortexdb.DefaultConfig("brain.db"))
defer db.Close()
brain := db.KnowledgeMemory()
_, _ = brain.Remember(ctx, cortexdb.KnowledgeMemoryRememberRequest{Content: "Alice prefers tabs.", Scope: "user"})
rec, _ := brain.Recall(ctx, cortexdb.KnowledgeMemoryRecallRequest{Query: "what does Alice prefer?"})
fmt.Println(rec.ContextPack.Text)
The plugin gives Claude Code and Codex one global brain at ~/.cortexdb/cortexdb.db, /remember, /recall and an auto-recall hook. Point several agents or machines at one cortexdb-grpc and they share the same memory and graph.
What's inside
- Vectors (HNSW, IVF, flat, binary codes), FTS5 full-text search, hybrid and graph retrieval
- RAG knowledge, scoped agent memory, context packs with sources
- RDF 1.2 knowledge graph: SPARQL, RDFS + OWL 2 RL inference, SHACL, read-only Cypher
- Palantir-style ontology with governed actions
- 80+ tools, in-process or over MCP
serve_graph_3d: a live 3D view to find, ask, query and expand, on desktop or phone- Change feed: every committed write, in order, exactly once
- SQLite by default, PostgreSQL + pgvector with a
postgres://DSN
Environment
| Variable | Meaning |
|---|---|
CORTEXDB_PATH |
Database file (default ~/.cortexdb/cortexdb.db) |
CORTEXDB_REMOTE |
Use a shared cortexdb-grpc at host:port instead of a local file |
CORTEXDB_GRPC_TOKEN |
Bearer token for that server |
CORTEXDB_GRPC_ADDR |
Server listen address (default 127.0.0.1:47821) |
CORTEXDB_EMBED_BASE_URL |
OpenAI-compatible embeddings endpoint; unset = lexical mode |
CORTEXDB_EMBED_MODEL / CORTEXDB_EMBED_DIM |
Embedding model and dimension |
Docs
Website · Guide (full feature reference) · Examples · Changelog · 中文
License
MIT
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found