cortexdb

mcp
Security Audit
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.

SUMMARY

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

Go Reference CI codecov License: MIT

AI memory and a knowledge graph in one SQLite file. Pure Go, no service to run, works without an embedding model.

The CortexDB live view

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)

No results found