cass 用于挖掘历史智能体会话，从过往对话中找回可复用的提示词、决策与工作模式。核心思路是：反复输入十次以上的提示词往往就是有效方法，挖掘历史优于重新发明。
主要能力：按关键词搜索会话（默认词法模式，可选语义或混合模式）；用聚合查看项目概览（谁在何时做了什么）；查看命中行上下文、展开完整对话、发现相关会话簇；导出会话为 JSON 供解析；将历史会话解析为原生 CLI（Claude Code、Codex、Gemini、OpenCode、pi_agent）的续接命令；配置远程来源实现跨机器搜索；按智能体类型排除某些 harness 的索引。
典型用法：先运行 cass status --json 检查健康状态，仅在索引过期时后台刷新（每次 cass index 调用都应加超时上限，例如 timeout 600 cass index --json）；用 cass search "KEYWORD" --workspace /path --json --fields minimal --limit 50 搜索，用户提示词通常位于会话前几行，可用 jq 过滤 line_number <= 3；用 cass view 或 cass expand 查看上下文；用 cass context 找相关会话；用 cass export -o 文件 导出（不要直接管道输出，可能触发 broken pipe）。
限制与注意：--limit 0 在旧版本会崩溃，聚合时至少传 --limit 1；宽范围扫描应加 --fields minimal 以节省上下文；workspace 路径大小写与结尾斜杠敏感，零结果时可用 --aggregate workspace 发现规范路径；cass 不索引工具输出，找不到内容时可回退到 rg；子智能体会话文件默认不可续接，需先解析到父会话；语义模式需先安装模型，未安装时会静默回退到词法模式。版本迭代较快，部分子命令与修复仅存在于较新版本，遇到不识别参数可运行 cass --version 并核对提交记录。具体收费、平台支持与效果数据暂未提供。