dezgit2025/auto-memory

auto-memory – AI编码代理的会话召回

功能

• 提供一个小巧、零依赖的CLI（session-recall及后端特定命令），用于读取GitHub Copilot CLI、Claude Code、Codex CLI等工具使用的本地SQLite会话存储。
• 读取前检查存储的schema版本。如果存储格式已更改（例如，新的OpenAI-Codex版本），工具会安全停止，并可启动修复工作流。
• 修复有固化的预审修复或AI辅助修复两种：后者要求Codex CLI（GPT-6 Astra）提出新的读取器方案。候选方案在合成数据上测试，必须获得用户批准后才能应用。
• 所有操作均为只读；除非用户明确应用修复，否则原始会话数据库不会被修改。

重要性

• 当会话存储schema发生变化时，AI编码代理会丢失上下文。没有兼容的读取器，代理就会看起来“失忆”，无法回忆之前的工作。
• auto-memory以每次查询几十个词元（“最后10个会话”约50词元）的代价恢复召回，显著减少重新解释过去工作所需的词元预算。

获取方法

• 使用隔离的Python工具管理器（推荐：pipx或uv）安装一次。README提供macOS（Homebrew Python 3.14）和Linux/WSL的精确命令。
• 安装后，为所使用的后端运行健康检查，例如：

  session-recall health                     # Copilot CLI
  SESSION_RECALL_ENABLE_CLAUDE_BACKEND=1 session-recall-cc health   # Claude Code
  session-recall-codex schema-check        # Codex CLI
  

• 固定GitHub标签v0.6.0（唯一发布的版本），以避免意外拉入未发布的新提交。

典型工作流

1. 检查兼容性 – session-recall-codex schema-check。
2. 如果兼容 – 查询存储，例如 session-recall list --json --limit 10。
3. 如果不兼容 – 使用 session-recall-codex-fix 启动修复。工具将：
   • 查找并自动应用捆绑的修复，或
   • 生成AI提议的修复，运行合成测试，并显示diff。
4. 批准候选方案（session-recall-codex-fix approve …）并应用。如果出现问题，可以通过 session-recall-codex-fix rollback … 回滚。

支持的端

后端	状态	激活方式
GitHub Copilot CLI	✅ 就绪（默认）	session-recall
Claude Code	🟡 可选（设置环境变量）	session-recall-cc
Codex CLI	✅ 召回 + 已审核修复；实验性AI修复	session-recall-codex
VS Code / JetBrains / Neovim	🟡 可选（额外安装步骤）	参见 deploy/install-other-backends.md

适用人群

• 依赖AI编码助手、希望代理无需重新提示即可记住先前会话的开发者。
• 运行多个AI后端（Copilot、Claude、Codex），需要单一轻量工具暴露本地会话历史的团队。
• 担心反复重新解释过去工作导致词元预算浪费的人。

限制

• AI辅助修复路径是实验性的，目前仅适用于macOS（需要sandbox-exec）。
• 包不提供Homebrew formula；采用隔离Python环境安装。
• 工具为只读，除非你明确应用修复；未经同意不会修改原始会话数据库。

---

快速开始（面向人）

# 安装（选择pipx或uv）
pipx install "auto-memory @ git+https://github.com/dezgit2025/auto-memory.git@v0.6.0"
# 验证安装
session-recall --version
# 对后端运行健康检查
session-recall health                     # Copilot CLI示例
# 列出最后10个会话（约50词元）
session-recall list --json --limit 10

快速开始（面向AI代理）

1. 阅读 deploy/install.md 并按照其分步说明操作。
2. 尊重 requires-user-confirmation 标志 – 在文件或shell rc修改前询问用户。
3. 安装后，运行适当的健康命令，然后使用 session-recall … 为代理提供过去工作的记忆。

---

许可证：MIT – 可自由使用、修改和再分发。