coding_agent_session_search

统一搜索本地多个AI编程助手的对话历史

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:coding_agent_session_search。
它的用途是:统一搜索本地多个AI编程助手的对话历史
完整的 Skill 内容见:https://321skill.com/skills/coding-agent-session-search/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

当你遇到一个‘数据库连接超时’错误,但隐约记得几周前 Claude Code 解决过类似问题时,可以对你的 AI 助手说:‘请使用 CASS 搜索我过去一个月内关于“数据库连接超时”的所有对话历史。’ AI 助手会执行 `cass search '数据库连接超时' --robot --days 30`,并解析返回的 JSON 结果,将找到的相关历史会话和解决方案呈现给你。

介绍

CASS 解决了 AI 编程助手(如 Claude Code、Cursor、Aider 等)的对话历史分散在不同位置、难以统一检索的问题。它作为一个高性能的 CLI/TUI 工具,能够自动索引来自 11 种主流编程助手的本地会话文件,将它们聚合到一个可搜索的数据库中。

使用时,用户通过简单的命令行即可进行搜索,例如 cass search 'authentication error' --robot。关键在于,为 AI Agent 调用时必须使用 --robot--json 标志来获取机器可读的 JSON 输出,避免启动会阻塞终端的交互式界面。它还提供健康检查、索引重建、会话导出等管理功能。

这个工具非常适合频繁使用多个 AI 编程助手进行开发的工程师、研究员或技术团队。当你在一个新项目中遇到似曾相识的问题,或者想回顾过去某个代理是如何解决特定 bug 时,CASS 能让你快速从所有历史对话中找到相关上下文,实现跨代理的知识复用和经验传承。

与仅能搜索单一工具历史的脚本或仅支持全文检索的通用搜索工具不同,CASS 专为 AI 编程场景设计,原生支持按代理、工作区、时间范围等元数据过滤,并提供了 --robot 模式、API 自省 (cass introspect --json) 和优化过的文档 (cass robot-docs) 等功能,使其能无缝集成到 AI Agent 的工作流中,作为 Agent 的“记忆”检索工具。

核心特点

核心区别在于其专为 AI Agent 消费而设计,提供了 `--robot` 模式和详尽的 JSON API,使得其他 AI Agent 可以程序化地查询和利用历史会话;同时,它原生支持聚合 11 种主流编程助手的本地历史,覆盖范围远超单一工具的历史查看器。

注意事项

不适合仅使用单一编程助手或不需要回顾历史对话的简单场景,且需要本地存在相应助手的会话文件才能建立索引。

常见问题

cass 命令卡住了怎么办?

这是因为直接运行 `cass` 会启动交互式 TUI 界面。为 AI Agent 调用时,必须在所有命令后加上 `--robot` 或 `--json` 标志。

如何让 AI Agent 获取当前工作区的会话?

使用命令 `cass sessions --current --json`,AI Agent 可以解析返回的 JSON 来获取当前工作区的最新会话路径和内容。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/coding-agent-session-search/raw/index.md 读取 coding_agent_session_search 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。