记忆

打开记忆

记忆默认 **关**。用下面任一方式打开（先匹配的生效）：

1. matcha --no-memory — 始终关
2. matcha --experimental-memory — 开
3. MATCHA_MEMORY=1 或 0
4. ~/.matcha/config.toml 里 [memory] enabled = true
5. 默认：关

会话中途开关

/memory on
/memory off

别名：/mem。该开关是 **会话范围**。它不改写 config.toml。关会移走本次会话的记忆工具，文件留在磁盘。开会重新初始化本地存储并再次注册工具。

不带参数的 /memory 打开浏览器（需要已配置的记忆目的地，即便你当前把它关掉了）。在该模态框里，t 是同一个开关。

记下一条：`/remember`

/remember 始终在斜杠菜单里。

/remember always open PR links after pushing

不带文字时，Matcha CLI 进入 remember 模式（提示符带 remember 强调色）。你接下来输入的一行成为笔记。

随后打开复查面板。确认后写入。保存时应看到类似 Memory saved to ~/.matcha/memory/MEMORY.md。项目特定笔记进工作区 MEMORY.md；跨项目偏好进全局文件。

也可以在普通对话里说 “remember …”。持久副本仍是 Markdown 文件。要保证删掉，自己编辑文件（或用 matcha memory clear）。让助手 “forget …” 只是尽力而为。

磁盘上有什么

共享同一 git origin（org/repo）的克隆和工作树共用一个工作区目录。否则哈希来自目录路径。

会话结束时，Matcha CLI 可能追加一段 **元数据** 摘要（消息数、几个主题、UTC 时间），**不**调用 LLM。琐碎会话会跳过。这是本地记账，不是 /flush。

文件监视器会重新索引你在编辑器里做的修改。/memory 里的预览只读；用 y 复制路径再去编辑。

浏览：`/memory`

/memory

分栏：文件列表（Global / Workspace / Sessions）和预览。窄终端隐藏预览。

从 shell 清除

matcha memory clear
matcha memory clear --workspace
matcha memory clear --global
matcha memory clear --all
matcha memory clear --yes

默认范围是工作区（MEMORY.md、sessions/ 和本地索引）。--yes 跳过确认提示。

目前没有什么

要留下事实，用 /remember（或编辑 MEMORY.md）。要丢掉一份存储，用 matcha memory clear 或删除文件。

你应该看到