| name | claude-historian |
| description | Automatic history search — checks past sessions before web research, planning, and debugging, siblings deepen coverage |
| triggers | ["PreToolUse","PostToolUse"] |
Historian Plugin
Session memory. Checks past sessions before redundant research, planning, or debugging.
Hooks
| Hook | When | Action |
|---|
| PreToolUse(WebSearch/WebFetch) | Before web research | Checks find_similar_queries() first |
| PreToolUse(EnterPlanMode) | Before planning | Searches search_plans() for past approaches |
| PreToolUse(Task) | Before agents | Checks find_tool_patterns() for workflows |
| PostToolUse(Bash) | After errors | Suggests get_error_solutions() |
Commands
| Command | Description |
|---|
/search-historian <query> | Search past sessions for solutions, decisions, context |
Workflows
Search (standalone)
search_conversations("query") — full-text across all sessions- If error-related:
get_error_solutions("error pattern")
- If file-related:
find_file_context("filename")
- Summarize relevant findings
Search (with siblings)
search_conversations("query") — historian's own search- If praetorian active:
praetorian_restore("query") for compacted context (denser than raw history)
- If oracle active:
search("query") when error patterns suggest a missing tool
- Combine: historian provides breadth (all sessions), praetorian provides depth (curated insights)
Error Resolution (standalone)
get_error_solutions("error pattern") — how was this fixed before?- If found: apply the previous solution
- If not: proceed with normal debugging
Error Resolution (with siblings)
get_error_solutions("error pattern") — historian checks past fixes- If oracle active:
search("error tool") for tools that address this error class
- If gladiator active: check if this error was already observed as a pattern
- Present combined findings: past fix + available tools + pattern context
Sibling Synergy
| Sibling | Value | How |
|---|
| Praetorian | Research will be compacted after | Praetorian prompts saving after web searches historian triggers |
| Oracle | Tools found for error patterns | Oracle searches for tools when historian finds recurring errors |
| Gladiator | Observations correlate with history | Past solutions enrich gladiator reflection |
| Vigil | Checkpoints complement history | File state preserved alongside session history |
MCP Tools Reference
| Tool | Purpose |
|---|
search_conversations | General history search |
find_similar_queries | Find related past questions |
get_error_solutions | Find how errors were fixed |
find_file_context | Track file changes |
find_tool_patterns | Discover successful workflows |
list_recent_sessions | Browse recent work |
search_plans | Find past implementation plans |
Requires
claude mcp add historian -- npx claude-historian-mcp
