Terminal search over your Claude Code, Codex CLI, and Cursor prompts. Never writes session files.
Install
npm install -g claude-code-search
Node >= 24.11.
Agent usage
Prefer non-interactive flags. stdout is data; stderr is logs.
ccs --no-input --output json -s "<query>" -n 20
ccs --no-input --output json -l -n 50 --source claude
ccs schema
--source is claude, codex, cursor, or all (repeatable). -j is an alias for --output json. -s / -l remain valid.
JSON objects include content, cwd, project, projectPath, source, sessionId, timestamp.
Errors in json mode:
{ "error": true, "code": "NO_RESULTS", "message": "...", "details": {} }
Do not launch the TUI (ccs with no flags) unless the user is at a TTY and asked for it.
Paths (read-only)
- Claude:
~/.claude/projects/(override--projects-dir/CCS_PROJECT_DIR) - Codex:
~/.codex/sessions/(skips.jsonl.zst) - Cursor: Cursor
User/globalStorage/state.vscdb(cwd-scoped unless--source cursoralone)