memwhale

MemoryWhale 是面向开发者和编码代理的持久化本地调试记忆层。它捕获调试过程中实际发生的情况——命令、输出、失败以及有效的修复方法——并将这些证据存储在本地 SQLite 数据库中。这使开发者及其 AI 编码代理即使在终端会话、SSH 连接或代理会话结束后，也能检索过去的解决方案。 该工具采用本地优先设计：无需账户、托管服务或按 token 计费的记忆服务，也不会上传任何内容。它通过 Model Context Protocol (MCP) 与 19 个编码代理集成，为不同工具之间的记忆访问提供统一的接缝。 主要功能包括： - **捕获**：通过 `mw global on` 或 `mw-run` 记录 shell 命令，并可用 `mw remember` 保存明确的经验教训。对于较长时间的工作，可使用抗崩溃的实时会话模式（`mw --live`）。 - **检索**：使用 `mw search` 搜索过去的失败和修复，或用 `mw context --last-error` 为代理生成紧凑上下文。 - **界面**：提供 CLI、交互式终端 UI（`mw tui`）、本地 Web 仪表盘（`mw-serve`）和桌面应用。MCP 访问可通过 stdio（`mw-mcp`）或 HTTP 使用。 - **代理集成**：`mw integrate` 为 Claude Code 和 Rho 等客户端设置 MCP 访问、捕获钩子和记忆使用指导。`mw doctor` 检查设置。 - **来源追踪**：将代理身份（例如 `claude`、`rho`）与来源类型分开存储，保持记忆历史透明。 - **Git 感知**：规范仓库 ID 将关联的工作树分组，发现过程读取本地 Git 元数据。 - **GitHub 上下文**：`mw github context <pr>` 通过现有的 `gh` 登录获取 PR 元数据、检查和审查，无需后台同步。 MemoryWhale 定位为调试记忆层，而非自主代理或通用记忆系统。它特别适用于调试构建、依赖、Git、环境或部署的开发者，以及跨多台机器工作或使用编码代理的开发者。 安装可通过 Linux 和 macOS 的预构建二进制文件、Cargo（`cargo install memorywhale-cli`）或 Homebrew 进行。该项目采用 MIT 许可证，包含文档、集成指南和贡献路径。LongMemEval 上的基准测试显示出强大的检索性能，受控评估表明启用记忆后代理的问题解决能力有显著提升。