AGF 本地编码会话查找器
统一搜索并恢复散落在本机的 AI 编码会话。
- 源仓库
- subinium/agf
- Star 数
- ★ 165
- 最近更新
- 1 个月前
- License
- MIT
- 主语言
- Rust
- FA 评分
- 77/100 · 表现良好
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 免费,无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 同时使用 Claude Code、Codex 和 Gemini CLI 的开发者,希望从一个终端列表找回正确会话。
- 不适合
- 需要云端跨设备同步会话的团队
- 主要使用 Amp 或 GitHub Copilot 的开发者
- 希望由 AGF 删除所有供应商会话的用户
- 维护状态
- 近半年有提交最近提交 2026-10-01最新版本 v0.15.1(2026-09-08)
- 源码审查
- 77/100 · 表现良好
这个 Agent 能做什么,适合哪些场景?
AGF 是一个以本地数据为中心的 Rust 命令行工具,用统一的 TUI 浏览和模糊搜索 16 种 AI 编码 Agent 保存的会话。它直接读取各工具已有的 JSON、JSONL 或 SQLite 存储,不要求账户、云同步或常驻的额外 Agent 进程。用户可以在交互界面中查看项目、路径、分支及可选摘要,也可以通过 agf resume 跳过 TUI,直接调用相应 Agent 的原生恢复命令。除交互界面外,它还提供版本化 JSON 命令、只读 stdio MCP 服务器,以及可供 Agent 集成的 AGF skill。其部署边界是用户自己的 macOS、Linux 或 Windows 机器;AGF 负责发现与交接会话,而实际恢复仍依赖对应的 Agent CLI。
AGF 扫描 Muse Code、Claude Code、Codex、Grok Build、Kimi Code、Qwen Code、Prime Agent、Gemini CLI、Antigravity CLI、Cursor CLI、OpenCode、Kiro、pi、Hermes、Oh My Pi 和 Yolop 的本地会话目录或数据库,并将结果合并成可搜索列表。TUI 支持按项目名、路径和分支进行模糊匹配,也能通过 F2 将有限数量的摘要纳入搜索;选中记录后,它会构造并运行该提供方的恢复命令。agf search、agf show、agf resume-plan 和 agf capabilities 输出版本化 JSON,其中 resume-plan 只返回待审查的参数、工作目录和受限存储环境,不会启动 Agent。agf mcp 通过 stdio 暴露相同的只读 API,并可用绝对项目路径限制返回记录。交互界面还提供详情、排序、项目分组、权限或审批模式选择以及批量删除,但部分提供方出于索引和附属文件一致性考虑禁用了直接删除。
- 同时使用 Claude Code、Codex 和 Gemini CLI 的开发者,希望从一个终端列表找回正确会话。
- 关闭终端或忘记会话 ID 后,需要按项目名、路径、分支或摘要恢复上下文的用户。
- 维护多个代码库的工程师,希望直接运行
agf resume <query>,跳过各 Agent 自带的会话选择器。 - 构建本地开发工具的团队,需要用版本化 JSON 或只读 MCP 接口查询现有编码会话。
- 准备清理旧会话的用户,希望先在 TUI 中跨项目检查并多选可安全删除的记录。
- 重视本地数据边界的团队,希望索引现有会话文件而不引入云同步服务。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
cargo install agf --lockedbrew install subinium/tap/agfcargo install --path . --locked
- 环境变量
SESSION_ID- 运行环境
- Rust 1.88
- 安装说明涉及
- Windows · macOS · Linux
如何安装或部署这个 Agent?
最直接的 Cargo 安装方式需要 Rust 1.88 或更高版本,以及用于内置 SQLite 的 C 编译器:
cargo install agf --locked
agfmacOS 或 Linux 也可以通过 Homebrew 安装:
brew install subinium/tap/agfmacOS、Linux 和 Windows 还提供无需 Rust 工具链的预编译二进制文件。若需要让 AGF 改变父 shell 的目录,可运行可选设置命令,然后重启 shell 或按提示重新加载配置:
agf setup从源码安装的命令如下:
git clone https://github.com/subinium/agf.git
cd agf
cargo install --path . --locked
agf setup恢复会话时,还需安装目标会话对应的 Agent CLI,例如 codex、claude、gemini 或 muse;仅浏览、JSON 查询和 MCP 服务不要求 shell 集成。
如何使用这个 Agent?
启动交互式会话浏览器:
agf按查询直接恢复最匹配的会话:
agf resume project-name限定为 Muse Code 并搜索或恢复:
agf list --agent muse
agf resume --agent muse project-name
agf search parser --agent muse --include-summaries面向脚本或 Agent 工具时,可使用只读 JSON 命令检查搜索结果、单条记录、恢复计划和能力:
agf search parser --agent codex --limit 10
agf show SESSION_ID --agent codex --include-summaries
agf resume-plan SESSION_ID --agent codex
agf capabilities以 stdio MCP 服务器运行,并将结果限制到指定项目:
agf mcp --agent codex --project /absolute/project/pathTUI 中输入文字即可搜索,方向键或 Ctrl+K/Ctrl+J 导航,Enter 打开动作菜单,Ctrl+L 查看详情,Tab 切换 Agent 过滤器,F2 切换摘要搜索,Ctrl+D 进入批量删除模式。
这个 Agent 有哪些优点和局限?
- 单一界面覆盖 16 种编码 Agent,并针对每种工具读取其真实的本地 JSON、JSONL 或 SQLite 存储。
- 采用本地优先模型,无需账户、云同步或额外常驻 Agent 进程;JSON 和 MCP 查询也保持只读。
- 既提供完整 TUI,也提供快速恢复、版本化 JSON、
resume-plan和 stdio MCP,便于人机两类工作流。 - 恢复前会固定解析出的可执行文件、存储根目录、工作目录和相关环境,降低切换目录造成的调用偏差。
- 支持 Unicode/CJK 搜索、无颜色模式、深浅主题以及不依赖颜色的选中和匹配提示。
- 它只管理本机已保存且可恢复的会话,不提供云端同步或跨机器共享。
- 真正恢复会话依赖相应提供方的 CLI;只安装 AGF 不能替代
codex、claude、muse等程序。 - Prime Agent、Grok Build、Kimi Code、Qwen Code、Gemini、Antigravity 和 Muse Code 禁止从 AGF 直接删除会话。
- Amp 和 GitHub Copilot 没有扫描器,未列入支持范围。
- 部分提供方存在已记录的兼容边界,例如 Antigravity 仅支持默认存储位置,Hermes 恢复时使用当前 shell 目录。
- 用 Cargo 构建需要 Rust 1.88+ 和 C 编译器;父 shell 目录切换还要额外安装 shell 包装器。
这个 Agent 与同类方案有什么区别?
与逐个打开各 Agent 的原生会话选择器或手工翻查历史文件相比,AGF 将 16 种工具的本地会话汇总到同一个可搜索界面,并提供统一的 JSON 与 MCP 查询入口。不过它不会取代原生 Agent:恢复最终仍交给各自的命令行程序,部分会话的删除也必须回到提供方自己的选择器完成。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| AGF 本地编码会话查找器 当前 | 77 · 表现良好 | 命令行工具免费 | ★ 165 | 1 个月前 | Rust | Codex · Claude Code |
| Claude Code 蜂群管家 | 58 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 204 | 18 天前 | Rust | Claude Code |
| OpenCrabs 终端智能体 | 62 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 1k | 1 天前 | Rust | ChatGPT · Codex · OpenAI API · Claude API |
| Herdr 智能体终端运行环境 | 74 · 存在缺口 | 命令行工具免费 | ★ 52k | 1 天前 | Rust | — |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
证据显示,自动化接口和 MCP 以只读搜索、元数据查询及未执行的恢复计划为主;技能明确要求把摘要视为不可信内容、减少敏感摘要读取,并禁止把计划拼成 shell 命令。README 还说明项目作用域不是 OS 沙箱,CSV 保留源值,摘要可能含私密内容。扣分原因:TUI 和原生恢复、批量删除及 shell profile 设置仍会产生外部影响;删除有确认流程但并非所有可变更操作都有可见的恢复机制;依赖审计工作流存在,但本材料不足以证明依赖漏洞处置结果。
README、技能和 main.rs 对 JSON 搜索、展示、恢复计划及 MCP 的只读边界大体一致,技能也区分空结果、扫描失败和 SDK 错误;CI 文件列有锁定依赖的构建检查和审计任务。扣分原因:本次仅做静态审阅,不能确认这些流程实际通过,也未提供锁文件或各扫描器实现来核实依赖可用性及错误处理细节。
文档具体覆盖跨多个终端代理的本地会话发现、精确选择、项目作用域、摘要开关、分页和平台差异;技能规定狭窄查询、精确 ID、歧义时询问,并清楚区分发现与启动。扣分原因:支持范围限于有本地可恢复会话及已实现扫描器的代理,部分配置覆盖和删除能力明确不支持。
README 提供结构清晰的安装、升级、配置、按键、支持路径、示例和限制;LICENSE 与 Cargo 元数据一致标注 MIT,Cargo.toml 和发布工作流体现版本及发布检查。扣分原因:样本未包含完整变更历史和明确的维护责任说明,不能确认维护者响应或后续更新承诺;代理命名存在 CLI 名称与展示名称并存的情况。
产品把多种本地会话存储统一为可搜索列表,并提供可供脚本和 MCP 使用的版本化 JSON、分页以及可审查的恢复计划;示例说明了常见工作流。扣分原因:效益取决于安装了对应原生 CLI 且会话存储兼容;扫描范围和摘要限制也意味着某些记录或内容不会出现。
README、技能、CLI 参数定义、Cargo 元数据和 CI 配置对主要功能、边界、版本与许可证提供了可追溯的相互印证。扣分原因:功能行为主要由文档与 CLI 入口描述,样本没有包含核心扫描、恢复和删除实现;CI 文件描述的是配置中的检查,不构成本次执行或通过证明。
- 恢复计划只是数据;启动原生代理前应核对准确的代理、会话 ID、工作目录和参数。
- 摘要和元数据可能含私密或不可信文本;项目作用域不构成系统级隔离。
- 删除与 shell 设置会修改本地状态;不同代理的删除支持不一致,部分代理应使用其原生界面管理会话。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
发布说明摘录
agf 0.15.1 Dependency Refresh - Upgrade dirs 6 -> 7, rusqlite 0.39 -> 0.40.2 and sha2 0.10 -> 0.11. - Remove the old transitive generic-array dependency. SHA-256 cache and Gemini project identifiers keep their existing encoding, verified with fixed vectors. - Keep Rust 1.88 support: libsqlite3-sys 0.38.2 fixes the build-macro issue that previously prevented the SQLite upgrade. No unsafe MSRV override is used. Installation And Documentation Use cargo install agf --locked to install the release-tested dependency graph, …在 GitHub 查看 ↗ -
发布说明摘录
agf 0.15.0 Agent Tools - Versioned, read-only JSON search, exact session metadata, resume plans and capabilities. No hidden TUI or native-agent execution. - Local stdio MCP using the official Rust SDK, with fixed scopes, bounded requests, modern/legacy interoperability tests and a portable Skill. - Resume plans preserve literal arguments, the selected executable, cwd and storage-root environment without modifying the parent shell environment. Compatibility And Safety - SLT 0.24.0 and current/legacy Gemini session formats. …在 GitHub 查看 ↗ -
发布说明摘录
agf v0.14.1 New agent support - Grok Build — discovers official xAI sessions under $GROK_HOME/sessions (default ~/.grok/sessions), surfaces durable activity, title, recap, branch, and worktree metadata, and resumes the exact selected ID with grok --resume. - Kimi Code — discovers v1/v2 state.json sessions under $KIMI_CODE_HOME/sessions (default ~/.kimi-code/sessions), recovers migrated legacy cwd metadata through session_index.jsonl, and resumes with kimi --session. …在 GitHub 查看 ↗
常见问题
AGF 会把会话内容上传到云端吗?
只安装 AGF 就能恢复所有会话吗?
JSON 和 MCP 接口会修改 Agent 的存储吗?
search、show、resume-plan、capabilities 及 stdio MCP 使用同一套只读 API;resume-plan 只输出计划,不启动 Agent。扫描失败时 AGF 会修复损坏的数据吗?
是否能从 AGF 删除任何提供方的会话?
agy 的 /resume 选择器删除。AGF 本地编码会话查找器 免费吗?
AGF 本地编码会话查找器 开源吗?
AGF 本地编码会话查找器 安全吗?
AGF 本地编码会话查找器 还在维护吗?
AGF 本地编码会话查找器 是谁开发的?
谢谢反馈,我们会据此改进页面。