Agent Skills: glhf — Conversation History Search

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 | Update index (incremental by default)|

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

1. Always use --compact — significantly reduces output tokens
2. Use --mode semantic for "how to" questions and conceptual searches
3. Use -e (regex) for exact error messages and patterns
4. Chain commands: search → get session ID → view summary → get full context
5. Current project/session auto-excluded when running inside Claude Code — use --include-this-project or --include-this-session to override
6. Use -p . to filter to current project when you want to include it
7. Use --json when piping to other tools or processing programmatically
8. Index is incremental — glhf index only re-processes changed files (~0.1s). Use --full to rebuild from scratch
9. Search shows staleness hints — if the index is behind, it prints how many files changed and when last indexed. Run glhf index to update