AgentRecall

本地桌面工具 · 搜索、查看、恢复 AI Coding Agent 会话

简体中文 ｜ English

AgentRecall 帮你把分散在不同 AI Coding Agent 里的本地会话找回来：统一索引、搜索、查看上下文，并在需要时继续或迁移会话。它优先面向个人本地使用，支持 macOS 与 Windows。

本 README 介绍当前稳定的 AgentRecall 1.0。仓库中的 apps/main-2.0 是独立运行的 agent-recall-v2 开发版，两者不共享应用数据，也不提供自动导入。

核心能力

能力	说明
统一搜索	跨 Claude Code、Codex 及十余种可选来源索引会话，支持关键词、标签、收藏、时间范围和来源筛选
完整上下文	查看消息、工具调用、Markdown、代码块、附件和 AI 摘要，可导出 Markdown 或常见模型请求 JSON
继续与迁移	从搜索结果一键回到原 Agent 继续对话，或在支持的本地 Agent 之间迁移会话
跨设备恢复	通过你自己的 Supabase 项目同步会话快照，在另一台设备搜索、查看并恢复
用量与额度	统计各 Agent 的 token 使用量，查看 Claude Code / Codex 的额度状态

支持的数据源

默认支持 Claude Code 和 Codex。更多来源可在 Settings -> Optional sources 中开启。

类型	来源
默认来源	Claude Code CLI、Claude Desktop app、Codex CLI、Codex Desktop
可选本地来源	CodeBuddy、CodeWiz、TClaude、TCodex、OpenClaw、Hermes、OpenCode、ZCode、Cursor Agent、Trae、Qoder
扩展环境	Windows WSL、SSH 远程环境

不同来源的可用能力略有差异；应用会在界面中按来源展示可用的查看、恢复、迁移和统计操作。

快速开始

准备 Node.js 22.13+，安装最新 Release：

npm install -g https://github.com/zszz3/AgentRecall/releases/latest/download/agent-recall.tgz
agent-recall

也可以把下面这段话直接贴给你的 AI Agent（Claude Code、Codex 等），让它帮你安装：

请帮我安装 AgentRecall：先确认 Node.js 22.13 或更高版本可用，然后执行 npm install -g https://github.com/zszz3/AgentRecall/releases/latest/download/agent-recall.tgz。如果 npm 或 Electron 下载缓慢，追加 --registry=https://registry.npmmirror.com 并设置环境变量 ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/ 后重试。安装完成后运行 agent-recall 确认能正常启动；遇到问题请阅读 https://github.com/zszz3/AgentRecall/blob/main/Install.md 排查。

系统	启动命令	默认快捷键
macOS	agent-recall	⌥ Option + Space
Windows	agent-recall	Ctrl + Alt + Space

启动后应用会常驻菜单栏或系统托盘，设置、主题、语言和快捷键都可以在应用内调整。macOS 上执行 agent-recall install-app 可以生成本地 AgentRecall.app，之后直接从 Launchpad / Spotlight / Dock 打开。更新执行 agent-recall --update 即可；完整安装、更新、回滚、卸载和国内镜像说明见 Install.md。

隐私与安全

• 会话索引与元数据只保存在本机 SQLite 数据库中，不经过任何第三方服务器。
• 各 Agent 的原始会话文件仅作为只读输入；恢复与迁移都会创建新副本，不改写原始会话。
• 跨设备同步完全可选，使用你自己的 Supabase 项目；应用只在本地保存 Project URL 与 anon key。
• 不收集任何遥测或使用数据。
• 代码完全开源，行为可审计。

进阶能力

• 远程同步：配置同一个 Supabase URL 与 anon key 后，另一台设备可以搜索、查看云端会话，并恢复到 Claude Code、Codex、CodeBuddy、CodeWiz 或 Cursor；支持手动上传，也可以安装 Claude Code / Codex Hook 自动记录待同步会话。同步按个人项目设计，删除云端副本不会影响本地会话。
• MCP 工具：内置 agent-recall-mcp，让 Claude Code、Codex、CodeBuddy 等在对话中搜索和读取历史会话，并管理标签、收藏、可见性或执行跨 Agent 迁移。
• Skills 与数字资产：查看、筛选和管理本机 Codex / Claude Code Skills，并通过 Supabase 在多台机器间同步 Skills、Rules（如 CLAUDE.md、AGENTS.md、Qoder rules）和 Memories（Qoder / Codex 记忆）。

这些能力复用应用内的同一份 Supabase 配置，适合个人跨设备使用。

参与贡献

欢迎提交 Issue 和 PR。本地开发：

git clone https://github.com/zszz3/AgentRecall.git
cd AgentRecall
npm run setup:v1
npm run dev:v1

开发 agent-recall-v2 时改用 npm run setup:v2 和 npm run dev:v2。两个应用分别位于 apps/main-1.0 与 apps/main-2.0，根目录命令负责统一测试、类型检查和构建。

提交前请阅读 CONTRIBUTING.md，并确保 npm test、npm run typecheck 与 npm run release-note:check 通过。

Collaborators

Blue-Berrys	G-Pegasus	zszz3	mesakurax	LANSGANBS	forbbiden1
MeloMei

Star History

开源协议

本项目基于 MIT License 开源。

Note

AgentRecall 是独立的开源项目，与 Anthropic、OpenAI、Cursor 等公司均无关联。Claude、Codex 等名称与商标归其各自所有者所有。

有任何问题，请提交 Issue。如果觉得项目对你有帮助，欢迎 Star。