crewmemory

为你团队中的每个 AI 编码智能体提供的一个共享记忆 — Claude Code、Codex、Cursor、 Gemini CLI、opencode、Windsurf、Claude Desktop 或任何 MCP 客户端。

记忆存放在你拥有的 git 仓库中（GitHub 或任何 git 托管服务）。每次保存都会自动提交并推送；每次读取都会先拉取最新内容。当你队友的智能体记录了一个修复、一个决策或它正在做的事情——你的智能体几秒钟后就能知道。

无需运行服务器。没有云数据库。没有锁定：就是纯 markdown + git。

安装

一条命令（包发布后）

uvx --from crewmemory-mcp crewmemory install codex --repo https://github.com/org/crewmemory.git --user alice --launcher uvx

将 codex 替换为 claude-code、claude-desktop、cursor、gemini、opencode 或 windsurf。当安装了 uv 时，同样的命令在 Windows、macOS 和 Linux 上都能使用。 注册后重启客户端。

如果使用私有记忆仓库，还需要传入 --token <fine-grained-token>；请使用限定到该仓库、具有 Contents 读/写权限的 token。

从源码检出安装

uv venv .venv
uv pip install --python .venv/bin/python -e .
.venv/bin/crewmemory install codex --repo https://github.com/org/crewmemory.git --user alice

在 Windows 上，可执行文件为 .venv\Scripts\crewmemory.exe。

支持的客户端：claude-code、claude-desktop、codex、cursor、gemini、opencode、 windsurf。安装程序会备份并合并现有配置，具有幂等性，并保存一个私有本地连接配置，因此 crewmemory doctor 和 crewmemory ui 可以在智能体之外使用。

或者直接让你的 AI 来做

把以下内容粘贴到当前文件夹中运行的智能体：

把你自己安装为 Claude Code 的 crewmemory MCP 服务器。我的记忆仓库是 https://github.com/org/crewmemory.git，我的名字是 alice，token 是 github_pat_xxx。

智能体会替你运行 crewmemory install claude-code ...。无需手动调用工具。

项目检测

会话开始时，MCP 指令会告诉智能体调用 team_context(project_path="<absolute workspace root>")。这会动态选择当前的 Git 仓库和分支，因此一次全局 MCP 安装即可跨项目使用。crewmemory init 是可选的，它会在本地注册表中记录一个项目，供人工和诊断使用。

crewmemory init            # registers the project; reads branch/git identity

随时验证

crewmemory doctor          # config, connectivity, project detection, counts

Related MCP server: bikky

人工仪表盘（无需智能体）

crewmemory ui              # opens http://127.0.0.1:8765 in your browser
crewmemory ui --port 9000 --no-browser

一个面向整个团队的本地 Web 仪表盘——无需询问智能体即可看到一切：

• 团队现在 — 谁现在在做什么、进度条、⛔ 阻塞、过期标记

• 活动 — 完整时间线：每个人的每条笔记/决策/方案/状态/删除

• 记忆 — 浏览和搜索全部六种类型，按作者/种类筛选，展开全文

• 资料 — 成员角色、时区、git 身份

• 概览 — 按类型/作者/项目/生命周期的计数 + 存储信息

只读，仅绑定 127.0.0.1，每 30 秒自动刷新。零额外依赖。

Windows

完全支持：

uv venv .venv-win
uv pip install --python .\.venv-win\Scripts\python.exe -e .
.\.venv-win\Scripts\crewmemory.exe install claude-code --repo ... --user alice --token ...
.\.venv-win\Scripts\crewmemory.exe ui

在所有平台上，成员名称都会被清理为安全的文件名（_member_filename）；Codex 的 TOML 值会针对 Windows 路径/反斜杠/引号正确转义；所有 git 调用都以 GIT_TERMINAL_PROMPT=0 运行，因此不会因等待输入而挂起。

你的智能体可以做什么（工具）

功能清单

• 共享团队记忆 放在你自己的 git 主机上 · 个人私有记忆（仅本地范围，永不推送）

• Git 原生存储：markdown + YAML frontmatter，零冲突文件策略（唯一文件名、按用户区分的状态/活动文件）

• 自动会话同步：每次读写都会同步 · 手动同步工具 · 离线安全（写入在本地提交，推送稍后重试）

• 用户与成员资料，从 git config 自动创建（crewmemory init）

• 进度跟踪与阻塞跟踪，在团队状态中带有过期标记

• 决策记忆、坑、模式、方案、交接 — 六种条目类型

• 记忆生命周期：未验证 → 已验证 → 已取代/过期，并带有 置信度分数，会随时间和关联代码的变化而衰减（代码变更感知衰减）

• 保存时的冲突/重复检测 + 合并查找器

• 溯源：作者归属、与提交关联的记忆、每条记忆的完整 git log --follow 历史

• 时间旅行：在任何 commit/tag/branch 读取团队记忆

• 分支感知上下文：条目记住 project+branch；recall 会提升当前分支的匹配结果

• 上下文预算管理：recall 将最佳记忆打包进字符预算

• 代码集成：文件关联记忆支持 PR 与决策对照、PR 后的过时记忆检测、“这段代码为什么存在”查询、blame 交叉引用、提交摘要

• 按项目记忆：条目会标记检测到的 project slug；状态显示 project@branch

• 分面搜索：tags、author、file、type、project（语义搜索：未来工作）

• 基于 MCP、stdio 传输，默认自托管/开源

仓库结构（自动创建）

notes/ decisions/ solutions/ gotchas/ patterns/ handoffs/   # memory types
status/     current focus per member (task, %, blockers)
activity/   append-only timeline per member
profiles/   member profiles

配置（每个成员）

手动配置片段（如果你更喜欢自行编辑配置）位于安装程序中——它写入的正是这种结构：

{ "mcpServers": { "crewmemory": {
    "command": "/path/to/crewmemory",
    "env": { "CREWMEMORY_REPO_URL": "...", "CREWMEMORY_USER": "...", "CREWMEMORY_TOKEN": "..." }
} } }

Codex 使用 ~/.codex/config.toml 中的 [mcp_servers.crewmemory]；OpenCode 使用 mcp.servers.*.type=local 结构——两者都由 crewmemory install codex/opencode 处理。

推荐的团队工作流

添加到你的 CLAUDE.md / AGENTS.md：

At session start call team_context(project_path="<absolute workspace root>"), then update_status() for your task.
Use recall() before researching anything the team may know.
Save durable learnings immediately (log_solution/log_decision/save_gotcha/save_pattern).
When switching tasks update update_status(); at day's end call save_handoff().

或者直接使用内置提示词：/session-start、/session-end、/pr-review-flow。

安全

• 永远不要将机密保存到记忆中——它是一个可读的 git 仓库。

• 公共记忆仓库会让每一条团队笔记、状态、路径和交接都公开。请优先使用私有仓库。

• 预期配置是私有仓库 + 细粒度 PAT（每个成员一个，Contents: RW）。

• Token 只保留在本地环境/配置中；所有 git 输出在到达智能体之前都会被脱敏。

发布

该仓库包含跨平台 CI、wheel/sdist 检查，以及 PyPI 可信发布工作流。发布清单请参阅 PUBLISHING.md。

故障排查

• crewmemory doctor 会诊断所有问题并打印准确的修复方法。

• 认证失败 → token 需要对记忆仓库具有 Contents Read+Write 权限。

• 重试后仍推送失败 → 更改在本地是安全的（已排队）；稍后运行 sync_memory。

• "Points to a different remote" → 删除 ~/.crewmemory/<repo> 或设置 CREWMEMORY_LOCAL_PATH。