airaneel/mnemos
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Autonomous memory for AI agents. Bi-temporal graph + episodic log + procedural skills. MCP-native.
3 commits 1 branch 0 tags 114 KiB
  • Go 98.8%
  • Makefile 0.6%
  • Dockerfile 0.6%
Find a file
Exact
Andrey 52f2b30784 Sprint 5+6: reflect (skill extraction), markdown importer, decay, search_nodes 
- consolidate/reflect.go: group (message → tool_call*) chains per scope,
  skip if correction event landed inside, upsert as procedural skill
  with deterministic UUIDv5-shaped ID so reflect passes are idempotent
- store: RecentEvents (chronological window, no vector), DecayImportance,
  SearchNodes
- migrations 000005_decay
- imports/markdown: walk .md, parse front-matter (created/tags),
  scope from relative path
- cmd: import markdown subcommand
- tests: groupChains, readMarkdown, pathToScope, joinScope
2026-05-04 20:51:24 +03:00
cmd Sprint 5+6: reflect (skill extraction), markdown importer, decay, search_nodes 2026-05-04 20:51:24 +03:00
configs Sprint 1+5: real storage SQL, consolidate worker, per-scope LLM, claude importer 2026-04-27 16:59:41 +03:00
internal Sprint 5+6: reflect (skill extraction), markdown importer, decay, search_nodes 2026-05-04 20:51:24 +03:00
pkg/types Sprint 1+5: real storage SQL, consolidate worker, per-scope LLM, claude importer 2026-04-27 16:59:41 +03:00
.gitignore Sprint 0: bootstrap mnemos memory server 2026-04-27 15:08:17 +03:00
.golangci.yml Sprint 0: bootstrap mnemos memory server 2026-04-27 15:08:17 +03:00
docker-compose.yml Sprint 0: bootstrap mnemos memory server 2026-04-27 15:08:17 +03:00
Dockerfile Sprint 0: bootstrap mnemos memory server 2026-04-27 15:08:17 +03:00
go.mod Sprint 0: bootstrap mnemos memory server 2026-04-27 15:08:17 +03:00
go.sum Sprint 0: bootstrap mnemos memory server 2026-04-27 15:08:17 +03:00
LICENSE Sprint 0: bootstrap mnemos memory server 2026-04-27 15:08:17 +03:00
main.go Sprint 0: bootstrap mnemos memory server 2026-04-27 15:08:17 +03:00
Makefile Sprint 0: bootstrap mnemos memory server 2026-04-27 15:08:17 +03:00
PLAN.md Sprint 0: bootstrap mnemos memory server 2026-04-27 15:08:17 +03:00
README.md Sprint 0: bootstrap mnemos memory server 2026-04-27 15:08:17 +03:00

README.md

mnemos

Autonomous memory for AI agents. Bi-temporal graph + episodic log + procedural skills. One Go binary, one Postgres. MCP-native. MIT.

mnemos is a memory server that any MCP-compatible client (Claude Desktop, Claude Code, Cursor, Windsurf, custom agents) can connect to. It stops agents from forgetting between sessions and gives them a real bi-temporal knowledge graph instead of a flat vector store.

Why another memory system

mnemos Memory MCP MemPalace Mem0 Graphiti
Bi-temporal graph ✅ ❌ ⚠️ flat ❌ ✅
Procedural skills ✅ ❌ ❌ ❌ ❌
Multi-agent scoping ✅ ❌ ❌ ⚠️ ⚠️
Sleep consolidation ✅ ❌ ❌ ❌ ❌
Single binary ✅ ❌ ❌ ❌ ❌
Any LLM (OAI-compat) ✅ n/a ❌ ❌ ❌

Quick start

# Build
go build -o mnemos .

# Run migrations
./mnemos migrate up

# Serve over HTTP for Claude Desktop
./mnemos serve --addr :8090

MCP tools exposed

Tool Purpose
mnemos.observe record an event into the episodic log
mnemos.recall hybrid retrieval (vector + graph + time)
mnemos.facts bi-temporal facts about an entity
mnemos.skill recall a procedural pattern
mnemos.pin add to core memory (always returned)

See PLAN.md for architecture and roadmap.

Status

Boilerplate only. Sprint 0 done. Sprints 1–7 in PLAN.md.

License

MIT