Kiroku Memory
Cross-session, cross-project memory for AI Agents.
Commands
Execute via scripts/:
| Command | Script | Args |
|---|---|---|
/remember | remember.py | <content> [--category CAT] [--global] |
/recall | recall.py | <query> [--context] |
/forget | forget.py | <query> |
/memory-status | memory-status.py | (none) |
Scopes
global:user— Cross-project (personal preferences)project:<name>— Project-specific (architecture decisions)
Default: project directory → project scope; otherwise → global scope.
Categories (by priority)
preferences (1.0) > facts (0.9) > goals (0.7) > skills (0.6) > relationships (0.5) > events (0.4)
Hooks
- SessionStart: Auto-loads memory context via
/contextAPI - Stop: Auto-saves important content (dual-phase: regex + async LLM)
References
- API Contract — Endpoint specs
- Scopes — Scope resolution logic
- Filtering Rules — What gets saved
- Retrieval Policy — Priority & truncation
- Auto-Save — Two-phase memory capture details