{
  "schemaVersion": "1",
  "revision": "22ce5d34dbcb5a78",
  "id": "factory-tools-conversation-search",
  "slug": "tools-conversation-search",
  "title": "Agent conversation search (cs)",
  "summary": "Tool roles, alternatives, selection tradeoffs, and compatibility caveats.",
  "category": "Tools",
  "tags": [
    "tools",
    "conversation-search"
  ],
  "sources": [
    {
      "label": "Tool comparison reference",
      "url": "https://dewy-sleet-n5zs.here.now/#conversation-search"
    }
  ],
  "sourceUnits": [
    "resources/index.html#conversation-search"
  ],
  "collection": "factory",
  "categoryId": "tools",
  "wordCount": 317,
  "url": "/topics/factory-tools-conversation-search/",
  "markdownUrl": "/markdown/factory-tools-conversation-search.md?raw=1&v=22ce5d34dbcb5a78",
  "jsonUrl": "/api/v1/documents/factory-tools-conversation-search.json",
  "headings": [
    {
      "id": "agent-conversation-search-cs",
      "text": "Agent conversation search (cs)",
      "level": 2
    },
    {
      "id": "pick-this-if",
      "text": "Pick this if…",
      "level": 3
    }
  ],
  "markdown": "# Agent conversation search (cs)\n\nTool roles, alternatives, selection tradeoffs, and compatibility caveats.\n\n## Agent conversation search (cs)\n\n**John uses:** `cs` — his personal conversation-search CLI (`cs <term> --recent -n 20`) over all local Claude/Codex/Grok session history; section 00's fact-check of a month-old field guide against ~1,978 oracle sessions ran on it. **We could not find a public repo for cs; treat it as personal/unreleased.**\n\n| Alternative | What it is | How it differs | License |\n|----|----|----|----|\n| [cc-sessions-viewer](https://github.com/jerrywu001/cc-sessions-viewer) | Viewer for Claude Code/Codex/Antigravity/OpenCode sessions: global search, token stats, resume, HTML export | Closest public match: multi-agent session search in a UI rather than a grep-style CLI | none listed |\n| [claude-conversation-extractor](https://github.com/ZeroSumQuant/claude-conversation-extractor) | Extract clean conversation logs from Claude Code's internal storage | Extraction/export only — pipe the output into ripgrep for search; check current repository activity | MIT |\n| [llm logs (Simon Willison)](https://github.com/simonw/llm) | Every llm CLI prompt/response logged to SQLite; \\`llm logs -q\\` full-text search | Only covers conversations you run through llm, but the SQLite pattern is the most robust searchable-history design | Apache-2.0 |\n| [ripgrep over ~/.claude/projects and ~/.codex/sessions](https://github.com/BurntSushi/ripgrep) | Both Claude Code and Codex store sessions as local JSONL — rg searches them directly | The zero-tool option: \\`rg -l 'term' ~/.claude/projects\\` gets you 80% of cs today | MIT/Unlicense |\n| [ccusage](https://github.com/ccusage/ccusage) | npx ccusage — analytics over Claude Code local session data | Adjacent: usage/cost analytics over the same JSONL files, not content search | NOASSERTION |\n\n### Pick this if…\n\n- **ripgrep** — start here; it's 80% of `cs` with zero new tools.\n- **cc-sessions-viewer** — you want cross-agent search in a UI with resume/export (young project).\n- **claude-conversation-extractor** — you want clean markdown exports to feed other tools.\n- **llm logs** — you're building new habits and want history searchable by design.\n- **ccusage** — you want the cost/usage half of session mining."
}
