Key Features
3-Layer Memory
Rule, Working, and Long-term layers with automatic priority ordering and TTL support.
Hybrid Search
Semantic vector search + BM25 full-text search with 4-component scoring.
Knowledge Graph
Entity nodes, bi-temporal edges, and graph traversal for structured knowledge.
Session & Episode Tracking
Track work sessions with checkpoints and log significant events as episodes.
Config Generation
Export stored memories as rule files for Claude Code, Cursor, Copilot, Windsurf, and more.
Zero Cloud Dependencies
Runs entirely local. SQLite + sqlite-vec. No API keys, no network calls for storage.
How It Works
- Your AI agent connects to Cohaku via MCP (stdio transport)
- The agent uses 24 tools to store, search, and manage memories
- Everything is persisted locally at
~/.config/cohaku/memory.db
Tool Categories
| Category | Tools | Description |
|---|---|---|
| Context | 1 | Load prioritized memory context at session start |
| Memory | 6 | Store, search, update, delete, deduplicate memories |
| Knowledge Graph | 5 | Entities, edges, traversal-based graph search |
| Episodes | 3 | Chronological event logging with entity references |
| Sessions | 4 | Work session lifecycle with checkpoints |
| Config Generation | 9 | Export memories to editor-specific rule files |
Next Steps
Quickstart
Set up Cohaku in under 5 minutes
Architecture
Understand the system design
CLI Reference
Manage memories from the terminal
Integrations
12 supported AI coding tools