本地 TUI/CLI 工具，统一索引与搜索 18+ 种编码代理的会话历史，支持全文、语义及混合搜索。
coding-agent-search（CLI 命令 cass）将 Claude Code、Codex、Cursor、Aider、Gemini CLI 等 18+ 种编码代理的异构会话日志统一归一化到本地 SQLite 数据库，提供亚 60ms 全文搜索与可选的本地语义搜索。
核心搜索能力基于 Edge N-Gram 前缀索引实现 O(1) 前缀匹配，智能 Tokenization 正确处理 snake_case、代码符号等；语义搜索使用 FastEmbed 加载 MiniLM 模型纯本地推理，默认混合搜索模式以词汇为必经快速路径、语义精化按需叠加。未安装模型时自动退回纯词汇搜索。
提供基于 FrankenTUI 的三面板交互界面（筛选栏、颜色编码结果列表、语法高亮预览），同时支持 --robot/--json 非交互模式供 AI 代理调用，遵循 stdout=数据、stderr=诊断、exit 0=成功的协议约定。
所有数据本地处理，HTML 导出支持 AES-GCM 加密，支持 macOS Keychain 解密 ChatGPT 加密对话。底层依赖作者自维护的 FrankenSQLite、FrankenSearch、FrankenTUI 等 sibling 仓库，通过 Git rev pinned 形成自包含工具链。支持 Linux、macOS（Apple Silicon & Intel）、Windows，可通过脚本、Homebrew、Scoop 安装。
搜索引擎特性#
| 特性 | 说明 |
|---|---|
| 全文搜索 | Edge N-Gram 前缀索引，查询 O(1) 查找，延迟 < 60ms |
| 智能 Tokenization | 正确处理 snake_case、连字符术语、代码符号（c++、foo.bar） |
| 语义搜索（可选） | FastEmbed + MiniLM 模型，纯本地推理，查询时零网络 |
| 混合搜索 | 默认模式：词汇为必经快速路径，语义精化在就绪时叠加 |
| 词汇回退 | 语义资产不可用时自动退回纯词汇搜索 |
| 零停顿更新 | 后台索引器原子提交，reader.reload() 确保新消息即时可搜 |
多代理数据源#
覆盖 Claude Code、Codex、Gemini CLI、Cline、OpenCode、Amp、Cursor、ChatGPT、Aider、Pi-Agent、GitHub Copilot Chat、Copilot CLI、OpenClaw、Clawdbot、Vibe、Crush、Kimi Code、Qwen Code、Factory (Droid) 等 18+ 代理。通过 cass sources agents list/exclude/include 管理数据源。
Robot 模式#
--robot / --json 非交互模式，子命令覆盖 health、search、sessions、view、expand、robot-docs、sources、resume。
安装方式#
# Linux / macOS
curl -fsSL "https://raw.githubusercontent.com/Dicklesworthstone/coding_agent_session_search/main/install.sh?$(date +%s)" | bash -s -- --easy-mode --verify
# Homebrew（Apple Silicon macOS + Linux）
brew install dicklesworthstone/tap/cass
# Windows Scoop
scoop bucket add dicklesworthstone https://github.com/Dicklesworthstone/scoop-bucket
scoop install dicklesworthstone/cass
语义模型可选安装：cass models install（在线下载 ~90MB）或 cass models install --from-file <dir>（离线）。