| name | glhf |
| description | Search Claude Code conversation history to find past solutions, recall commands, and discover related work. Use when looking for previous implementations, finding commands you ran before, or exploring what was done in past sessions. |
glhf
Search your Claude Code conversation history using hybrid search (text + semantic).
Quick Examples
# Find past solutions (semantic search)
glhf search "authentication" --mode semantic --compact
# Find commands you've run
glhf search "docker" -t Bash --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 |
-t Bash |
Filter by tool (Bash, Read, Edit, Grep, etc.) |
-p . |
Filter to current project |
--since 1d |
Time filter (1h, 2d, 1w, or date) |
--errors |
Only show error results |
--show-session-id |
Include session IDs for follow-up |
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
Find similar work:
glhf recent -l 10
glhf related <session-id> --limit 5
Debug past errors:
glhf search "error" --errors --since 1d --compact
Tips
- Always use
--compact- significantly reduces output tokens - Use
--mode semanticfor "how to" questions and conceptual searches - Use
--mode textfor exact keywords and error messages - Chain commands: search → get session ID → view summary → get full context
- Current project/session auto-excluded when running inside Claude Code
- Use
-p .to filter to current project when you want to include it - Use
glhf <command> --helpfor complete option documentation