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 /context API

• 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