chat-history

# chat-history Search, inspect, and export Claude Code, Cursor, and Codex conversation history. The short alias `ch` works identically. If the command is not found: `cargo install chat-history`. ## When to use - User asks about past conversations or sessions - User wants to find something they discussed before - User needs a summary of recent work / accomplishments - User wants to resume or export a previous session ## Process **Keyword question** ("find that conversation where I..."): 1. `chat-history search "<query>" --deep --json` — always `--deep --json` from agents. `--deep` searches full transcript content; `--json` returns structured results (`session_id`, `score`, `snippet`, `tools`, `files`). Note `--json` exists only on `search`. 2. Shortlist by snippet, not by raw score (see "Choosing the best hit"). 3. `chat-history inspect <partial-uuid>` on the top 2–3 candidates to confirm before answering. 4. `view` / `export` only if the user needs the actual content. **Temporal question** ("what did I work on yesterday?") — list, don't search: 1. `chat-history --from yesterday --to yesterday -v` — `-v` shows session IDs. - `--from X` alone means **X through today**. Always pair with `--to` when the user means a specific day. - `-s` groups by day for multi-day overviews, but the grouped view hides session IDs even with `-v` — use the flat `-v` list when you need IDs. 2. `chat-history inspect <id>` for accomplishments, tools, files touched. ## Choosing the best ...