ai-memory

项目简介

ai-memory 是一个自包含、自托管的长期记忆方案，面向 AI 编码代理 CLI。它通过生命周期钩子捕获观察，将会话摘要整理成项目 wiki 中的普通 Markdown 页面，并让后续代理在支持的运行环境和机器之间检索上下文或从带类型的交接继续工作。

核心功能

• 共享记忆：二十多个编码代理运行环境（包括 Claude Code、Codex、Cursor、Gemini CLI、OpenCode 等）共享同一份记忆，代理之间通过带类型且只能被认领一次的交接传递任务。
• Git 支持的 Markdown wiki 是事实来源，数据库只是可从文件重建的派生索引。
• 生命周期钩子静默捕获提示词、工具调用和会话边界，并在存储前经过带类型的隐私边界处理。
• 跨项目配置档案把工作习惯带入新仓库；由服务器承载的记忆可跟随用户跨机器和团队使用。
• 默认路径在捕获、搜索、交接以及衰减、压缩、去重和矛盾标记等老化操作中使用零次 LLM 调用。
• 可选的 LLM 整理、向量搜索和 dream 式重写默认关闭，且从不删除源版本。

适用场景

• 在同一项目目录中从一个编码代理切换到另一个后继续工作。
• 团队共用一台服务器共享项目知识，同时让个人交接保持私密。
• 通过自托管服务器从另一台机器恢复项目记忆。
• 为已有长期历史的现有项目引导记忆。

快速开始

• 在 Linux 或 macOS 上运行 install.sh 发布脚本，然后运行 ai-memory setup。
• 在 Windows PowerShell 中运行 install.ps1 发布脚本，然后运行 ai-memory setup。
• 使用 install-mcp 和 install-hooks 接入代理，或以 ai-memory run 启动运行环境，以便自动接入并获得会话连续性。
• 重启代理，并询问它记得这个项目的什么，以验证召回。

部署与要求

• 产品以单个自包含二进制形式发布，支持 Linux、macOS 和 NixOS 模块，并通过 WSL2 支持 Windows。
• 原生 Windows 在支持矩阵中列为实验性。
• 支持 Docker 或 Podman 部署，已发布的 Docker 镜像包含 linux/amd64 和 linux/arm64 变体。
• NixOS 模块需要 git 作为运行时依赖，并提供加固的 systemd 服务。
• 面向局域网或广域网绑定服务时，应在服务前放置 TLS；回环绑定可以省略密钥，并容忍环境文件缺失。

采用前须知

• 许可证：MIT。在使用、修改或分发项目前，请确认其具体条款。