noggin 是做什么的?
一个用于进行中工作的工作记忆树 —— 作为你无法记在脑子里的第二大脑。
概述
noggin 是一个为 AI 助手(如 Claude Code)设计的工作记忆系统。它通过树形结构组织你的进行中工作、上下文和临时想法,让 AI 可以随时记录和引用重要的信息片段,而不必担心在长对话中丢失上下文。
功能
- 树形工作区:每个工作区是一个节点,可以包含多个子节点,形成层级结构。
- 快速保存:使用
/mem或/noggin命令将当前上下文保存为节点。 - 精准检索:使用
/recall命令搜索已保存的记忆节点,支持关键词和路径过滤。 - 自动索引:每个节点自动生成摘要和时间戳,方便回溯。
- 跨会话持久化:所有数据保存在本地文件系统(默认
~/.noggin/),重启对话后仍可回忆。
使用方法
保存记忆
# 保存当前上下文为一个节点
/mem 工作区名称 # 或 /noggin 工作区名称
# 保存并关联子节点
/mem 父节点/子节点 详细内容
回忆记忆
# 搜索所有匹配的记忆
/recall 关键词
# 带路径过滤
/recall 父节点/子节点
查看记忆树
# 列出整个树结构
/mem --tree
配置
| 环境变量 | 默认值 | 说明 |
|---|---|---|
NOGGIN_DIR | ~/.noggin | 记忆树存储路径 |
NOGGIN_MAX_NODES | 100 | 单次会话树节点数量上限 |
NOGGIN_RECALL_LIMIT | 10 | 每次 recall 返回的最大节点数 |
注意事项
- 敏感信息(如 API Key、密码)不应存储在记忆树中,因为它是纯文本文件。
- 如果树节点过多,AI 的回复可能变慢;必要时可以手动清理
~/.noggin/下的旧数据。 - 本技能是为 Claude Code 设计的,在其他平台(如 Cursor)上可能需要适配命令前缀。
许可证
MIT