GenesisTools gt:claude-history

install

source · Clone the upstream repo

git clone https://github.com/genesiscz/GenesisTools

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/genesiscz/GenesisTools "$T" && mkdir -p ~/.claude/skills && cp -r "$T/plugins/genesis-tools/skills/claude-history" ~/.claude/skills/genesiscz-genesistools-gt-claude-history && rm -rf "$T"

manifest: plugins/genesis-tools/skills/claude-history/SKILL.md

source content

Claude History Search

Search through Claude Code conversation history to find past interactions.

Quick Reference

# 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

Common Use Cases

Find by Keywords

tools claude history "backup mcp-manager refactor"
tools claude history "authentication bug" --exact

Find by File Modified

tools claude history --file "config/api.php"
tools claude history --file "*.tsx" --tool Edit

Find by Tool Usage

tools claude history --tool Edit --since "7 days ago"
tools claude history --tool Task --limit 50

Find by Project

tools claude history "timer" --project GenesisTools
tools claude history "migration" --all  # Search all projects

Show Context

tools claude history "timer" --context 10  # 10 messages before/after

CLI Options

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

Output Formats

Default (ai): Perfect markdown with summaries and file paths With --context: Shows surrounding messages in markdown JSON: Raw JSON for programmatic use

Summarize Sessions

Summarize Claude Code sessions using LLM-powered templates. Extracts key information and produces structured output in 7 modes.

Quick Start

# 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

Summarization Modes

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

Summarize Options

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

Examples

# 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

Dashboard

For visual exploration,

tools claude history dashboard

launches a web-based React/Vite interface for browsing and analyzing conversation history.