用途：ccs 在终端中搜索本地 Claude Code、Codex CLI 与 Cursor 的提示历史，全程只读，不会写入会话文件。适合需要找回某条过往提示、对编码智能体会话文本做 grep，或把结果通过管道交给其他程序处理的场景。
安装：npm install -g claude-code-search，要求 Node >= 24.11。
主要能力：支持按来源筛选，--source 可取 claude、codex、cursor 或 all，且可重复指定；支持交互式 TUI 与非交互式两种模式。JSON 输出对象包含 content、cwd、project、projectPath、source、sessionId、timestamp 字段。
使用方式：面向智能体调用时建议使用非交互式参数，stdout 输出数据、stderr 输出日志。示例：ccs --no-input --output json -s "<query>" -n 20；ccs --no-input --output json -l -n 50 --source claude；ccs schema。其中 -j 是 --output json 的别名，-s 与 -l 仍然有效。json 模式下的错误形如 { "error": true, "code": "NO_RESULTS", "message": "...", "details": {} }。除非用户处于 TTY 且明确要求，否则不要启动 TUI（即不带任何参数运行 ccs）。
数据路径（只读）：Claude 为 ~/.claude/projects/，可用 --projects-dir 或 CCS_PROJECT_DIR 覆盖；Codex 为 ~/.codex/sessions/，会跳过 .jsonl.zst；Cursor 为 Cursor User/globalStorage/state.vscdb，默认按 cwd 限定范围，除非单独指定 --source cursor。
限制：仅覆盖上述三类来源的本地历史；资料未提供更多平台、收费或效果信息。