用途:当用户想找回此前与某个 AI 讨论过的内容(例如「上次我们怎么解决 Y 的」「翻一下历史」),用 trellis mem 跨平台、跨项目检索本地会话记录,把过去的对话内容作为当前上下文。数据只读本地存储,无守护进程、无索引、无上传。
前置条件:全局安装 Trellis CLI 0.6.17 或更高版本:npm install -g @mindfoldhq/trellis@latest,并用 trellis --version 确认。trellis mem 随 CLI 打包,无需额外配置。
主要能力:projects 列出活跃项目 cwd;search 在清洗后的对话中做多词 AND 搜索,返回按分数排序的会话与片段;context 按会话 id 抽取命中轮次及上下文,默认 6000 字符预算;extract 导出清洗后的完整对话,支持 --grep 与 --json;list 枚举会话。extract 的 --phase brainstorm 可按 task.py create 到 task.py start 的边界切出讨论阶段,--phase implement 取实现部分(OpenCode 会降级并给出警告)。
典型用法(两步下钻):先 trellis mem search "<topic>" [--cwd <项目>] [--since <日期>],再 trellis mem context <session-id> --grep <topic> --turns 3 --around 1。项目不明确时先跑 trellis mem projects。常用标志包括 --platform、--since/--until、--global、--cwd、--limit、--include-children、--json 等。
数据来源为各平台本地路径,例如 Claude 的 ~/.claude/projects/、Codex 的 ~/.codex/sessions/、Devin CLI 的 ~/.local/share/devin/cli/sessions.db、OpenCode 的 ~/.local/share/opencode/opencode.db 等。清洗会剥离系统提示、工具调用与噪声,保留真实人机对话,并保留压缩前的轮次。
限制:不用于检索代码或文件内容(用 Grep/Read),也不用于查提交历史(用 git log)。子智能体的内部轮次多数不可恢复。平台对各功能的支持程度不一,具体以 trellis mem help 为准。引用召回内容时应给出会话 id 和原句。