mcpField
A
agent-session-search

agent-session-search

github.com/oakossAgent 工作流2084 次安装10 周前更新
代码仓库

关于 agent-session-search

Agent Session Search 是一项技能，通过外部 CASS Rust 命令行工具索引和搜索本地编码 Agent 历史记录。它将来自 13 种以上 Agent 的会话汇总到一个索引中，并支持面向 Agent 工作流的机器可读搜索。

主要功能

  1. 01索引 13 种以上 Agent 的历史记录
  2. 02词法、语义和混合搜索
  3. 03JSON 与 robot 模式输出
  4. 04查看匹配会话及其上下文
  5. 05监视文件并更新索引

适用场景

  1. 01查找过去的编码 Agent 对话
  2. 02跨 Agent 工具搜索会话
  3. 03获取搜索命中附近的上下文

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/oakoss/agent-skills --skill agent-session-search

安装后在 Claude Code 中输入/agent-session-search确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
command-reference.md
configuration.md
error-handling.md
internals.md
query-language.md
remote-sources.md
robot-mode.md
search-and-ranking.md
tui-reference.md

详细介绍

Agent 会话搜索

用于索引和搜索本地编码 Agent 历史记录的统一 CLI/TUI。汇总来自 13+ 个 Agent 的会话，建立一个可搜索索引，延迟低于 60 毫秒。专为 AI Agent 使用打造，支持机器人模式和宽容的语法。这不是一个库——CASS 是需要单独安装的外部 Rust CLI。

请勿用于实时会话监控。如果 Agent 没有存储在磁盘上的本地会话历史记录，也请勿使用。

可通过 curl 单行命令、Homebrew 或 Scoop 安装（参见配置参考）。从源代码构建需要 Rust nightly 工具链。

重要：绝不要直接运行 cass——它会启动交互式 TUI 并阻塞当前会话。请始终使用 --robot 或 --json 标志。

基本命令

命令用途
cass health --json健康检查（退出码 0 = 健康，非 0 = 不健康）
cass index --full完整重建数据库和搜索索引
cass index自上次扫描以来的增量更新
cass index --watch监视模式：文件变更时自动重新索引
cass search "query" --robot搜索并输出 JSON
cass search "query" --robot --fields minimal最简载荷（路径、行号、Agent）
cass search "query" --robot --limit 5限制结果数量
cass search "query" --robot --mode hybrid使用混合（词法 + 语义）搜索
cass view /path -n 42 --json查看指定行的源内容
cass expand /path -n 42 -C 5 --json查看搜索结果周围的上下文
cass export-html /path将对话导出为独立 HTML
cass robot-docs guide面向大模型优化的文档
cass robot-docs schemas响应 JSON 架构
cass sources setup配置多机器远程来源

支持的 Agent

Agent位置格式
Claude Code~/.claude/projectsJSONL
Codex~/.codex/sessionsRollout JSONL
Gemini CLI~/.gemini/tmpJSON
ClineVS Code 全局存储任务目录
OpenCode.opencode 目录SQLite
Amp~/.local/share/amp + VS Code混合
Cursor~/Library/Application Support/Cursor/User/SQLite state.vscdb
ChatGPT~/Library/Application Support/com.openai.chatJSON（v1 未加密；v2/v3 已加密）
Aider~/.aider.chat.history.md + 每个项目Markdown
Pi-Agent~/.pi/agent/sessionsJSONL
Factory (Droid)~/.factory/sessionsJSONL
Clawdbot~/.clawdbot/sessionsJSONL
Vibe (Mistral)~/.vibe/logs/session/*/messages.jsonlJSONL

搜索模式

模式算法最适用于
词法（默认）通过 Tantivy 进行 BM25 全文搜索精确词项匹配、代码搜索
语义向量相似度（通过 FastEmbed 使用 MiniLM）概念查询、查找相似内容
混合倒数排名融合（RRF）平衡精确率和召回率

语义模式需要 MiniLM 模型文件。若文件不可用，CASS 会回退到基于哈希的嵌入器，以实现近似相似度搜索。

宽容语法

CASS 会自动纠正常见的 Agent 错误，并向 stderr 输出说明提示：

输入修正
命令中的拼写错误使用 Levenshtein 距离匹配规范命令
长选项使用单连字符（-robot）规范化为 --robot
大小写错误（--Robot）转换为小写的 --robot

常见错误

错误修正
直接运行 cass始终使用 --robot 或 --json
缺少 --robot 标志添加 --robot 以输出 JSON
不存在索引先运行 cass index --full
超出 Token 预算使用 --fields minimal 和 --limit
搜索结果过时运行 cass index 刷新
将 stderr 解析为 JSONstdout 仅包含 JSON，诊断信息会输出到 stderr
假设已安装 CASS先检查 cass health --json

委派

使用此技能通过 CASS CLI 对编码 Agent 会话历史进行索引、搜索和分析。所有操作均委派给外部 cass 二进制文件。运行 cass robot-docs guide，直接查阅已安装版本中的权威命令参考。

如需搜索多台机器上的会话，请参阅 Remote Sources。如需了解人工操作员如何使用 TUI，请参阅 TUI Reference。

参考文档

  • 命令参考 -- 索引、搜索、会话查看、导出和诊断
  • 机器人模式 -- 自描述 API、宽容的语法、输出格式、令牌预算
  • 查询语言 -- 布尔运算符、通配符、匹配类型、时间格式、自动模糊匹配回退
  • 搜索与排序 -- 搜索模式、排序、评分公式
  • 远程来源 -- 通过 SSH/rsync 在多台机器间搜索、设置向导、路径映射
  • TUI 参考 -- 键盘快捷键、主题、已保存视图、密度模式、书签
  • 错误处理 -- 结构化错误、退出代码、故障排除
  • 内部机制 -- 响应结构、去重、性能、监视模式、语义搜索
  • 配置 -- 环境变量、Shell 补全、安装、集成

评论

支持 Markdown