glhf — Conversation History Search
Search your Claude Code conversation history using hybrid search (text + semantic).
When invoked as /glhf <query>, run: glhf search "$ARGUMENTS" --mode semantic --compact
Quick Examples
# Find past solutions (semantic search)
glhf search "authentication" --mode semantic --compact
# Find commands you've run
glhf search "docker" -t Bash --compact
# Regex search for exact error messages
glhf search -e "ECONNREFUSED|ETIMEDOUT" --compact
# Search with context (like grep -C)
glhf search "panic" -C 2 --compact
# Check recent sessions
glhf recent -l 10
# Get session overview then dive deeper
glhf session abc123 --summary
glhf session abc123 --limit 50
Commands
| Command | Purpose |
|---|---|
search | Find content across all sessions |
session | View a specific session's content |
related | Find sessions similar to a given one |
recent | List recent sessions |
projects | List all indexed projects |
status | Show index stats |
index | Rebuild the search index |
Key Search Flags
| Flag | Purpose |
|---|---|
--compact | One-line output, fewer tokens |
--mode semantic | Conceptual search (how to X, patterns) |
--mode text | Exact keyword matching |
-e/--regex | Regex pattern matching (like grep -e) |
-i/--ignore-case | Case-insensitive (for regex mode) |
-A N/-B N/-C N | Context lines after/before/around matches |
-t Bash | Filter by tool (Bash, Read, Edit, Grep, etc.) |
-p . | Filter to current project |
-X name | Exclude a project by name (repeatable) |
--since 1d | Time filter (1h, 2d, 1w, or date) |
--errors | Only show error results |
--messages-only | Exclude tool calls |
--tools-only | Exclude messages |
--show-session-id | Include session IDs for follow-up |
--json | Machine-readable JSON output |
--scores | Show relevance scores |
--oldest | Reverse sort (oldest first) |
--include-this-project | Override auto-exclusion of current project |
--include-this-session | Override auto-exclusion of current session |
--this-session | Filter to current session only |
Recommended Patterns
Find past solutions:
glhf search "problem description" --mode semantic --compact
glhf search "specific keyword" --show-session-id --compact
glhf session <id> --summary
Recall commands:
glhf search "git rebase" -t Bash --compact
glhf search "cargo" -t Bash --since 1w --compact
Regex search for exact errors:
glhf search -e "thread.*panicked" --compact
glhf search -e "error\[E\d+\]" -i --compact
Find similar work:
glhf recent -l 10
glhf related <session-id> --limit 5
Debug past errors:
glhf search "error" --errors --since 1d --compact
Cross-project search (override auto-exclusion):
glhf search "auth" --include-this-project --compact
glhf search "deploy" -X stable -X dotfiles --compact
Tips
- Always use
--compact— significantly reduces output tokens - Use
--mode semanticfor "how to" questions and conceptual searches - Use
-e(regex) for exact error messages and patterns - Chain commands: search → get session ID → view summary → get full context
- Current project/session auto-excluded when running inside Claude Code — use
--include-this-projector--include-this-sessionto override - Use
-p .to filter to current project when you want to include it - Use
--jsonwhen piping to other tools or processing programmatically - Index with
--skip-embeddingsfor fast text-only reindex