AGF 本地编码会话查找器

统一搜索并恢复散落在本机的 AI 编码会话。

源仓库
subinium/agf
Star 数
★ 165
最近更新
1 个月前
License
MIT
主语言
Rust

30 秒速览

运行形态
命令行工具MCP 服务器Agent 插件 / 技能
可在哪里用
通用 · 跨平台Codex · Claude Code
费用
免费,无需付费服务
上手难度
低 · 几分钟可跑通
开始前需要
macOS、Linux,或配备 PowerShell 5.1+ 或 PowerShell 7+ 的 Windows恢复会话时需要一个或多个受支持的 Agent CLI使用 Cargo 构建时需要 Rust 1.88+ 和 C 编译器Shell / 命令行本地文件系统MCP Server
典型场景
同时使用 Claude Code、Codex 和 Gemini CLI 的开发者,希望从一个终端列表找回正确会话。
不适合
  • 需要云端跨设备同步会话的团队
  • 主要使用 Amp 或 GitHub Copilot 的开发者
  • 希望由 AGF 删除所有供应商会话的用户
维护状态
近半年有提交最近提交 2026-10-01最新版本 v0.15.1(2026-09-08)

这个 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,并可用绝对项目路径限制返回记录。交互界面还提供详情、排序、项目分组、权限或审批模式选择以及批量删除,但部分提供方出于索引和附属文件一致性考虑禁用了直接删除。

  1. 同时使用 Claude Code、Codex 和 Gemini CLI 的开发者,希望从一个终端列表找回正确会话。
  2. 关闭终端或忘记会话 ID 后,需要按项目名、路径、分支或摘要恢复上下文的用户。
  3. 维护多个代码库的工程师,希望直接运行 agf resume <query>,跳过各 Agent 自带的会话选择器。
  4. 构建本地开发工具的团队,需要用版本化 JSON 或只读 MCP 接口查询现有编码会话。
  5. 准备清理旧会话的用户,希望先在 TUI 中跨项目检查并多选可安全删除的记录。
  6. 重视本地数据边界的团队,希望索引现有会话文件而不引入云同步服务。

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
  • cargo install agf --locked
  • brew install subinium/tap/agf
  • cargo install --path . --locked
环境变量
SESSION_ID
运行环境
Rust 1.88
安装说明涉及
Windows · macOS · Linux

如何安装或部署这个 Agent?

最直接的 Cargo 安装方式需要 Rust 1.88 或更高版本,以及用于内置 SQLite 的 C 编译器:

cargo install agf --locked
agf

macOS 或 Linux 也可以通过 Homebrew 安装:

brew install subinium/tap/agf

macOS、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/path

TUI 中输入文字即可搜索,方向键或 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?

FollowAgents 源码审查 · FARS-2.1
表现良好
77/ 100 五分制 3.9 / 5
信任安全 18/29
可靠稳定 9/14
适用触发 18/18
规范维护 15/18
有效结果 12/13
证据核验 5/8
查看各维度的扣分理由
信任安全18 / 29 · 3.1/5

证据显示,自动化接口和 MCP 以只读搜索、元数据查询及未执行的恢复计划为主;技能明确要求把摘要视为不可信内容、减少敏感摘要读取,并禁止把计划拼成 shell 命令。README 还说明项目作用域不是 OS 沙箱,CSV 保留源值,摘要可能含私密内容。扣分原因:TUI 和原生恢复、批量删除及 shell profile 设置仍会产生外部影响;删除有确认流程但并非所有可变更操作都有可见的恢复机制;依赖审计工作流存在,但本材料不足以证明依赖漏洞处置结果。

可靠稳定9 / 14 · 3.2/5

README、技能和 main.rs 对 JSON 搜索、展示、恢复计划及 MCP 的只读边界大体一致,技能也区分空结果、扫描失败和 SDK 错误;CI 文件列有锁定依赖的构建检查和审计任务。扣分原因:本次仅做静态审阅,不能确认这些流程实际通过,也未提供锁文件或各扫描器实现来核实依赖可用性及错误处理细节。

适用触发18 / 18 · 5.0/5

文档具体覆盖跨多个终端代理的本地会话发现、精确选择、项目作用域、摘要开关、分页和平台差异;技能规定狭窄查询、精确 ID、歧义时询问,并清楚区分发现与启动。扣分原因:支持范围限于有本地可恢复会话及已实现扫描器的代理,部分配置覆盖和删除能力明确不支持。

规范维护15 / 18 · 4.2/5

README 提供结构清晰的安装、升级、配置、按键、支持路径、示例和限制;LICENSE 与 Cargo 元数据一致标注 MIT,Cargo.toml 和发布工作流体现版本及发布检查。扣分原因:样本未包含完整变更历史和明确的维护责任说明,不能确认维护者响应或后续更新承诺;代理命名存在 CLI 名称与展示名称并存的情况。

有效结果12 / 13 · 4.6/5

产品把多种本地会话存储统一为可搜索列表,并提供可供脚本和 MCP 使用的版本化 JSON、分页以及可审查的恢复计划;示例说明了常见工作流。扣分原因:效益取决于安装了对应原生 CLI 且会话存储兼容;扫描范围和摘要限制也意味着某些记录或内容不会出现。

证据核验5 / 8 · 3.1/5

README、技能、CLI 参数定义、Cargo 元数据和 CI 配置对主要功能、边界、版本与许可证提供了可追溯的相互印证。扣分原因:功能行为主要由文档与 CLI 入口描述,样本没有包含核心扫描、恢复和删除实现;CI 文件描述的是配置中的检查,不构成本次执行或通过证明。

风险与缓解建议
  • 恢复计划只是数据;启动原生代理前应核对准确的代理、会话 ID、工作目录和参数。
  • 摘要和元数据可能含私密或不可信文本;项目作用域不构成系统级隔离。
  • 删除与 shell 设置会修改本地状态;不同代理的删除支持不一致,部分代理应使用其原生界面管理会话。
证据充分度:低 评估于 2026年11月8日 审查版本 fc592e1a7a87
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/agf.svg?lang=zh)](https://followagents.com/zh/agents/agf)
<a href="https://followagents.com/zh/agents/agf"><img src="https://followagents.com/badge/agf.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v0.15.1
    发布说明摘录
    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 查看 ↗
  2. v0.15.0
    发布说明摘录
    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 查看 ↗
  3. v0.14.1
    发布说明摘录
    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 会把会话内容上传到云端吗?
不会。它读取 Agent 已保存在本机的会话文件或数据库,不要求账户或云同步;项目范围是结果过滤条件,不是操作系统级沙箱。
只安装 AGF 就能恢复所有会话吗?
不能。AGF 可以发现和检查本地记录,但启动恢复操作需要对应的 Agent CLI 已安装并可执行。
JSON 和 MCP 接口会修改 Agent 的存储吗?
不会。search、show、resume-plan、capabilities 及 stdio MCP 使用同一套只读 API;resume-plan 只输出计划,不启动 Agent。
扫描失败时 AGF 会修复损坏的数据吗?
不会。不可读或不兼容的存储会报告为扫描错误,AGF 不修复或重写提供方文件。
是否能从 AGF 删除任何提供方的会话?
不能。为避免破坏原生索引、活动会话或附属文件,多个提供方禁用直接删除;例如 Antigravity 应通过 agy 的 /resume 选择器删除。
AGF 本地编码会话查找器 免费吗?
免费。AGF 本地编码会话查找器 可以免费使用,不需要付费服务。
AGF 本地编码会话查找器 开源吗?
开源。源码在 GitHub(subinium/agf),许可证是 MIT。
AGF 本地编码会话查找器 安全吗?
FollowAgents 的 FARS 评审(2026年11月8日)给 AGF 本地编码会话查找器 的“信任与安全”打了 18/29 分。评审检查的 8 项安全措施没有完全缺失的。
AGF 本地编码会话查找器 还在维护吗?
更新变慢了:GitHub 上最近一次提交是 2026-10-01,在最近半年内,但不在最近 30 天内。最新版本是 v0.15.1(2026-09-08)。
AGF 本地编码会话查找器 是谁开发的?
AGF 本地编码会话查找器 由 GitHub 账号 subinium 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念