kiroku-memory

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Kiroku Memory

Kiroku Memory

Cross-session, cross-project memory for AI Agents.
为AI Agent提供跨会话、跨项目的记忆功能。

Commands

命令

Execute via
scripts/
:
CommandScriptArgs
/remember
remember.py
<content> [--category CAT] [--global]
/recall
recall.py
<query> [--context]
/forget
forget.py
<query>
/memory-status
memory-status.py
(none)
通过
scripts/
目录执行:
命令脚本参数
/remember
remember.py
<content> [--category CAT] [--global]
/recall
recall.py
<query> [--context]
/forget
forget.py
<query>
/memory-status
memory-status.py
(无)

Scopes

作用域

  • global:user
    — Cross-project (personal preferences)
  • project:<name>
    — Project-specific (architecture decisions)
Default: project directory → project scope; otherwise → global scope.
  • global:user
    — 跨项目(个人偏好)
  • project:<name>
    — 项目专属(架构决策)
默认规则:若在项目目录下则使用项目作用域;否则使用全局作用域。

Categories (by priority)

分类(按优先级排序)

preferences
(1.0) >
facts
(0.9) >
goals
(0.7) >
skills
(0.6) >
relationships
(0.5) >
events
(0.4)
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)
  • SessionStart:通过
    /context
    API自动加载记忆上下文
  • Stop:自动保存重要内容(双阶段:正则表达式 + 异步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
  • API 契约 — 端点规格
  • 作用域 — 作用域解析逻辑
  • 过滤规则 — 可保存内容规则
  • 检索策略 — 优先级与截断规则
  • 自动保存 — 双阶段记忆捕获详情