
字节笔记本
2026年10月5日 · 约 8 分钟读完
agent 会话找不回?试试 VibeTrail 全文搜索
你上周在某个项目里和 Claude Code 聊定了一个重要方案,这周想接着干,打开终端输入 /resume,列表里只有最近几条,翻了半天也找不到。想搜「上次修证书路径是在哪个会话里聊的」,官方工具干脆没有搜索功能。
这不是个别现象。所有重度使用 AI coding agent 的人都会遇到同一个问题:会话记录散落在 ~/.claude 和 ~/.codex 等本地目录里,官方工具只展示最近几条,找历史会话等于大海捞针。
两个真实痛点
痛点一:会话找不回。 agent 自带的 /resume 功能只列出最近几条会话,用上一两个月之后,想找上周甚至上个月某个 session 继续干活,基本无从下手;全文搜索更是没有,「那次讨论数据库 schema 的会话到底在哪」这个问题,官方工具没提供任何回答手段。
痛点二:项目找不回。 vibe coding 一时爽,几个月下来一时兴起开的项目散落一地,有些连目录在哪都想不起来。但 agent 的会话记录其实忠实记着你在每个目录干过什么,问题只是没有工具把它捞出来看。
VibeTrail 是什么

VibeTrail 是一个开源的 macOS 工具(Apache-2.0 协议,Rust + Tauri 实现,要求 macOS 14 及以上),把 Claude Code、Codex、Antigravity 等多家 agent 的本地会话读出来,做成统一的浏览和搜索入口。一句话定位:你的所有 AI agent 会话的全文搜索引擎。
需要说明的是,它是一个独立的第三方开源项目,与 Anthropic、OpenAI、Google 等厂商均无隶属关系,只读取这些工具已经存在你机器上的会话文件,并且严格只读。
三个核心能力
项目总览。 按工作目录聚合所有跑过 agent 的项目,最近干了什么一眼扫完,连早已遗忘的孤儿目录都会被标出来。作者提到,自己打开第一屏就找回了两个彻底遗忘的项目。它比 agent 自带的会话列表好用,关键在于按「项目」组织而不是按「时间」组织:你看到的是你在哪个目录做了什么,而不是某天某时某个 session。
全文搜索。 跨所有 agent、所有项目搜正文,也可以限定单个项目。命中后直接跳进会话定位到那条消息,浏览命中结果时搜索面板还保持打开。搜索引擎是把 ripgrep 的 crate 直接链进程序里的,不需要单独安装 rg,速度和 ripgrep 本尊一样快。这意味着你终于可以搜「上次那个关于 Redis 缓存策略的讨论在哪」了。

一键 resume。 看中哪条会话,点一下就帮你打开终端、cd 到项目目录、执行对应 agent 的 resume 命令,直接回到当时的上下文。支持的终端包括 Terminal.app、iTerm2、Ghostty 和 Warp。
除此之外还有不少细节:续会话、Codex fork 和 subagent 工作线程会自动折叠归组到根会话下面,不会把子任务和主任务混在一起;时间线用 Markdown 渲染对话,工具调用、执行结果和思考块折叠展示,超长的工具输出先给摘要、按需展开全文;每个会话有 token 统计;应用自带中英文界面,自动检测、随时切换。
技术实现:没有数据库的搜索引擎
| 维度 | 实现 |
|---|---|
| 框架 | Rust + Tauri,另有 vibetrail CLI 双入口 |
| 数据库 | 没有,也没有索引文件和常驻进程 |
| 搜索 | ripgrep 引擎 crate 直接内链,无需安装 rg |
| 数据来源 | 直接读取 ~/.claude、~/.codex 等本地目录 |
| 安全性 | 对 agent 目录严格只读,resume 前还会校验项目路径仍然存在 |
性能方面,作者在本机实测的数据是 2 万个 session、共 3.4GB,打开一个会话只需 0.06 秒,搜索速度与 ripgrep 持平。没有数据库、没有索引、没有常驻进程,每次都直接读文件还能这么快,这是 Rust 的功劳,也意味着它不会在你机器后台留下任何东西。
对脚本党还有个加分项:所有查询命令都支持 --json 输出,且 schema 做了快照测试,接自动化脚本很稳。几条常用命令长这样:
vibetrail projects # 所有项目,跨全部 agent
vibetrail search "race condition" # 全文搜索,按会话分组
vibetrail resume <session-id> # cd 到项目目录并执行对应的 resume和实时监控工具正好互补
社区里另有 abtop 这类 Agent 版 htop 工具,负责实时的 token 监控;VibeTrail 负责历史的会话搜索。两个工具加在一起,正好覆盖 AI agent 的时间维度:abtop 回答「现在 agent 在干什么」,盯 token 消耗、速率和端口;VibeTrail 回答「之前 agent 干过什么」,管会话内容和项目记录。两个都装上,对 agent 运行状态的掌控就完整了。
接入更多 agent 的空间
Provider 协议是开放的,仓库里的 TECH_SPEC.md 写清了架构决策、provider 协议和各家格式说明。目前的支持情况:Claude Code、Codex、Qoder 支持完整的浏览、搜索加 resume;Antigravity 和 Cursor 是实验性支持,其中 Antigravity 暂不支持 resume,Cursor 的 resume 会直接拉起 Cursor 应用。想接 Windsurf 等其它 agent,按协议实现一个 trait 加几个测试即可。随着更多 agent 工具产生本地会话数据,VibeTrail 有机会成为所有 AI coding agent 的统一会话管理入口。
获取方式
GitHub Releases 提供签名并公证过的 .dmg(GUI 版)和 CLI 压缩包,开箱即用;有 Rust 工具链的话也可以用 cargo 自行编译,GUI 走 Tauri v2,CLI 是 cargo build --release -p vibetrail-cli 一条命令的事。项目地址:https://github.com/mahui/vibe-trail
写在最后
VibeTrail 解决的是所有 AI coding agent 用户的共同痛点:会话散落各处、历史记录找不到、想接着干却 resume 不回来。它做的事情说起来很简单,把所有会话读出来、做全文搜索、一键 resume,但正是这件「简单」的事,官方工具一直没做好。2 万个 session、3.4GB 数据、0.06 秒打开、ripgrep 级搜索速度,加上没有数据库、没有常驻进程、严格只读的干净实现,这是一个真正对 agent 用户有用的小工具。



