agent-memory-hub

agent-memory-hub 是一个本地优先的 Agent 记忆与协作工作台。它用于归档 Codex、Claude 的历史会话，生成可检索的长期记忆，沉淀可复用 Skill，并通过 MCP 为 Agent 提供上下文恢复、任务续跑和多 Agent 自动开发能力。

项目默认语言为中文，Dashboard、说明文档和主要用户路径均以中文为主。

核心能力

  • 会话归档：导入 Codex 与 Claude 的本地会话，按项目浏览、搜索、导出。
  • 长期记忆：基于 SQLite 做关键词检索，可选接入 LanceDB 做语义检索。
  • Skill 沉淀：从高价值会话中生成候选 Skill，经人工审核后启用。
  • 上下文恢复：为历史会话生成恢复上下文包，支持任务续跑。
  • 多 Agent 自动开发：由 Desktop 设定总目标，再按轮次派发给 codex 或 cc 终端 worker；Windows 上默认弹出独立 PowerShell 工作窗口，同时在 Hub 保留摘要日志。Codex Desktop 内置子代理结果可通过 autodev_record_external_round 记录进 Hub 时间线。
  • 可视化 Dashboard：查看会话、记忆、技能、任务状态、自动开发轮次和健康检查。

快速运行

npm install
npm run build
npm run dashboard

默认 Dashboard 地址：

http://127.0.0.1:43121

默认数据目录：

%USERPROFILE%\.memory-hub

桌面启动脚本：

powershell -NoProfile -ExecutionPolicy Bypass -File scripts/start-agent-memory-hub.ps1

MCP 服务

源码构建后可注册本地 MCP：

powershell -NoProfile -ExecutionPolicy Bypass -File scripts/publish-integrations.ps1 -RegisterMcp -AllowExistingCredentialUse

注册的服务名：

agent-archive
agent-orchestrator
agent-autodev

常用命令

npm run build
npm run test
npm run check
npm run ingest
npm run dashboard
node dist/cli.js prune-skills

安全边界

  • 所有数据默认保存在本机 .memory-hub 目录。
  • Dashboard 只绑定 127.0.0.1。
  • API 需要本地 token。
  • 导出默认使用脱敏内容。
  • Skill 不会自动写入 Codex 或 Claude 的原生 skill 目录。
  • CLI worker 派发默认关闭，必须在 Dashboard 设置中显式启用。
  • 如需在测试或无人值守环境禁用可见终端窗口，设置 AGENT_HUB_CLI_WINDOW_MODE=hidden。
  • 如果机器没有 cc 命令但已安装 Claude Code，AutoDev 会自动回退到 claude。
  • 需要让 CLI worker 写入仓库外目录时，设置 AGENT_HUB_WORKER_EXTRA_DIRS，多个目录用 ; 分隔；该值会转换为 Codex/Claude CLI 的 --add-dir 参数。
  • 如需给 worker 追加 CLI 参数，设置 AGENT_HUB_CODEX_EXEC_ARGS 或 AGENT_HUB_CC_ARGS；中转场景可用同名 AGENT_RELAY_* 变量覆盖。