Stats
Actions
Tags
From genesis-tools
Use when the user wants to find or reference something from a past Claude Code conversation — a fix, solution, discussion, or decision they remember from an earlier session. Applies when they say things like "you helped me fix", "we debugged", "we discussed", "I remember asking you", "I need to reference our conversation", or when they want to locate a specific past interaction by topic, file, date, or vague recollection. Also covers summarizing past Claude sessions. Does NOT apply when searching codebases, git history, browser history, Slack logs, or any non-Claude source.
How this skill is triggered — by the user, by Claude, or both
Slash command
/genesis-tools:claude-historyThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Search through Claude Code conversation history to find past interactions.
Search through Claude Code conversation history to find past interactions.
# Basic search
tools claude history "keyword"
# Search with filters
tools claude history "query" --tool Edit --since "7 days ago"
# Interactive mode
tools claude history -i
tools claude history "backup mcp-manager refactor"
tools claude history "authentication bug" --exact
tools claude history --file "config/api.php"
tools claude history --file "*.tsx" --tool Edit
tools claude history --tool Edit --since "7 days ago"
tools claude history --tool Task --limit 50
tools claude history "timer" --project GenesisTools
tools claude history "migration" --all # Search all projects
tools claude history "timer" --context 10 # 10 messages before/after
| Option | Description |
|---|---|
-i, --interactive | Interactive mode with autocomplete |
-p, --project <name> | Filter by project name |
--all | Search all projects |
-f, --file <pattern> | Filter by file path pattern |
-t, --tool <name> | Filter by tool (Edit, Write, Bash, etc.) |
--since <date> | Since date (e.g., "7 days ago", "yesterday") |
--until <date> | Until date |
-l, --limit <n> | Limit results (default: 20) |
-c, --context <n> | Show N messages before/after match |
--exact | Exact match instead of fuzzy |
--regex | Use regex for query |
--agents-only | Only search subagent conversations |
--exclude-agents | Exclude subagent conversations |
--exclude-thinking | Exclude thinking blocks |
--reindex | Rebuild search index (use when index seems stale or after manual edits) |
--format <type> | Output: ai (default), json |
Default (ai): Perfect markdown with summaries and file paths With --context: Shows surrounding messages in markdown JSON: Raw JSON for programmatic use
Summarize Claude Code sessions using LLM-powered templates. Extracts key information and produces structured output in 7 modes.
# Interactive mode — guided session & mode selection
tools claude history summarize -i
# Summarize a specific session
tools claude history summarize <session-id> --mode documentation
# Summarize current session (inside Claude Code)
tools claude history summarize --current --mode short-memory
# Output prompt only (no LLM call)
tools claude history summarize <session-id> --prompt-only --mode changelog
| Mode | Description |
|---|---|
documentation | Full technical doc: problem, changes, patterns, lessons |
memorization | Comprehensive learnings organized by topic tags |
short-memory | Concise MEMORY.md-ready bullets (500-2000 chars) |
changelog | Added/Changed/Fixed/Removed with file paths |
debug-postmortem | Symptoms, investigation, dead ends, root cause, fix |
onboarding | "How this works" for new devs: architecture, key files |
custom | Your own prompt with session content |
| Option | Description |
|---|---|
-s, --session <id> | Session ID (repeatable) |
--current | Use current session from $CLAUDE_CODE_SESSION_ID |
--since <date> | Sessions since date |
--until <date> | Sessions until date |
-m, --mode <name> | Template mode (default: documentation) |
--model <name> | LLM model name |
--provider <name> | LLM provider name |
--prompt-only | Output the prepared prompt without calling LLM |
-o, --output <path> | Write output to file |
--clipboard | Copy output to clipboard |
--thorough | Chunked summarization for large sessions |
--max-tokens <n> | Token budget (default: 128000) |
--include-tool-results | Include tool execution results |
--include-thinking | Include thinking blocks |
--priority <type> | Content priority: balanced, user-first, assistant-first |
-i, --interactive | Interactive guided flow |
--custom-prompt <text> | Custom prompt (for custom mode) |
--memory-dir <path> | Output dir for memorization topic files |
# Generate onboarding docs from a session
tools claude history summarize abc123 --mode onboarding -o docs/onboarding.md
# Extract debug learnings
tools claude history summarize abc123 --mode debug-postmortem --clipboard
# Memorization with topic files
tools claude history summarize abc123 --mode memorization --memory-dir ./memory/
# Large session with chunked processing
tools claude history summarize abc123 --mode documentation --thorough
# Custom analysis
tools claude history summarize abc123 --mode custom --custom-prompt "List all API endpoints discussed"
# Use specific model
tools claude history summarize abc123 --mode short-memory --provider anthropic --model claude-sonnet-4-5-20250929
For visual exploration, tools claude history dashboard launches a web-based React/Vite interface for browsing and analyzing conversation history.
npx claudepluginhub genesiscz/genesistools --plugin genesis-toolsSearches and recalls previous Claude Code conversation sessions by querying a local SQLite FTS5 index or JSONL log files.
Searches Claude Code conversation history by topic or date filters, returning session IDs and project paths for resumption via 'claude --resume'. For queries like 'find conversation about X' or 'what did we do yesterday'.