Vvkmnn avatar

claude-historian

Automatic history search hooks for historian MCP (checks past work before research)

version
1.0.0
GitHub stars
80

Install

/plugin install claude-historian@claude-emporium

Run it inside Claude Code after adding the marketplace with /plugin marketplace add Vvkmnn/claude-emporium.

Contents

Discovered from source

Skills 1

Historian Plugin

Session memory. Checks past sessions before redundant research, planning, or debugging.

Hooks

HookWhenAction
PreToolUse(WebSearch/WebFetch)Before web researchChecks find_similar_queries() first
PreToolUse(EnterPlanMode)Before planningSearches search_plans() for past approaches
PreToolUse(Task)Before agentsChecks find_tool_patterns() for workflows
PostToolUse(Bash)After errorsSuggests get_error_solutions()

Commands

CommandDescription
/search-historian <query>Search past sessions for solutions, decisions, context

Workflows

Search (standalone)

  1. search_conversations("query") — full-text across all sessions
  2. If error-related: get_error_solutions("error pattern")
  3. If file-related: find_file_context("filename")
  4. Summarize relevant findings

Search (with siblings)

  1. search_conversations("query") — historian's own search
  2. If praetorian active: praetorian_restore("query") for compacted context (denser than raw history)
  3. If oracle active: search("query") when error patterns suggest a missing tool
  4. Combine: historian provides breadth (all sessions), praetorian provides depth (curated insights)

Error Resolution (standalone)

  1. get_error_solutions("error pattern") — how was this fixed before?
  2. If found: apply the previous solution
  3. If not: proceed with normal debugging

Error Resolution (with siblings)

  1. get_error_solutions("error pattern") — historian checks past fixes
  2. If oracle active: search("error tool") for tools that address this error class
  3. If gladiator active: check if this error was already observed as a pattern
  4. Present combined findings: past fix + available tools + pattern context

Sibling Synergy

SiblingValueHow
PraetorianResearch will be compacted afterPraetorian prompts saving after web searches historian triggers
OracleTools found for error patternsOracle searches for tools when historian finds recurring errors
GladiatorObservations correlate with historyPast solutions enrich gladiator reflection
VigilCheckpoints complement historyFile state preserved alongside session history

MCP Tools Reference

ToolPurpose
search_conversationsGeneral history search
find_similar_queriesFind related past questions
get_error_solutionsFind how errors were fixed
find_file_contextTrack file changes
find_tool_patternsDiscover successful workflows
list_recent_sessionsBrowse recent work
search_plansFind past implementation plans

Requires

claude mcp add historian -- npx claude-historian-mcp

Commands 1

/search-historian

Search past Claude sessions for solutions, decisions, and context.

Usage

/search-historian <query>

Examples

  • /search-historian auth implementation - Find auth-related work
  • /search-historian "module not found" - Find error solutions
  • /search-historian package.json - Find file changes

Action

Call mcp__claude-historian-mcp__search_conversations(query="<query>", limit=5)

MCP servers 1

Sponsors

Details

Marketplace
Vvkmnn/claude-emporium
Source
plugins/claude-historian
Author
vvkmnn
Category
Productivity

More from Vvkmnn/claude-emporium

All 6