Skip to main content
plugin

claude-historian — Claude Code plugin: session history search

claude-historian — a plugin that searches your past sessions before web research, planning, and debugging. Reuses solutions you've already found and prevents redundant work.

MIT ★ 78 updated 2026-03-05

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add Vvkmnn/claude-emporium
/plugin install claude-historian@claude-emporium
Open on GitHub

What claude-historian does

claude-historian activates through hooks at key moments: before web searches, before entering plan mode, before launching agents, and after command failures. When relevant history is found, Claude reuses it; when not, work continues without interruption.

The plugin relies on the claude-historian-mcp MCP server and exposes seven search tools: general session search, related question discovery, error fix lookup, file change tracking, workflow pattern detection, recent session browsing, and plan history search. All four main hooks are on by default but can be toggled in ~/.claude/settings.json under the claude-historian key.

Typical savings run 200–800 tokens per avoided duplicate search.

What it helps with

  • find how you fixed an error in a past session
  • recall solutions to similar problems you've solved
  • avoid repeating web searches on the same topic
  • discover successful workflow patterns from your history
  • track changes to a specific file across your sessions

Example prompts for the agent

  • Find past solutions for a 404 error you've encountered before
  • /search-historian React component caching strategies I've used
  • Show me implementation plans I created for similar API designs

How to install claude-historian

Plugin marketplace

/plugin marketplace add Vvkmnn/claude-emporium
/plugin install claude-historian@claude-emporium

Step by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own

Questions about claude-historian

How do I install claude-historian in Claude Code?

Run two commands in order: /plugin marketplace add Vvkmnn/claude-emporium, then /plugin install claude-historian@claude-emporium. Make sure the MCP server is installed: claude mcp add historian -- npx claude-historian-mcp.

What does claude-historian do?

It automatically searches your session history before web research, planning, and debugging. When it finds relevant past work, it suggests reusing it instead of starting from scratch.

What do I need for claude-historian to work?

You need the claude-historian-mcp MCP server, installed with claude mcp add historian -- npx claude-historian-mcp. Without it, the plugin won't function.

Source text

claude-historian · MIT
# Claude Historian

Automatic history search for Claude Code. Checks past sessions before you do redundant web research, planning, or debugging.

## Installation

```bash
/plugin marketplace add Vvkmnn/claude-emporium
/plugin install claude-historian@claude-emporium
```

## Requirements

MCP server: [`claude-historian-mcp`](https://www.npmjs.com/package/claude-historian-mcp)

```bash
claude mcp add historian -- npx claude-historian-mcp
```

## Hooks

| Event | Trigger | What It Does |
|-------|---------|-------------|
| `PreToolUse` | `WebSearch` · `WebFetch` | Checks history before web research |
| `PreToolUse` | `EnterPlanMode` | Searches past plans before planning |
| `PreToolUse` | `Task` | Checks tool patterns before launching agents |
| `PostToolUse` | `Bash` | Suggests error solutions after command failures |

## Commands

| Command | Description |
|---------|-------------|
| `/search-historian <query>` | Search past sessions for solutions, decisions, context |

## MCP Tools

| 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 |

## Settings

Configure in `~/.claude/settings.json` under `claude-emporium`:

```json
{
  "claude-emporium": {
    "suggest_siblings": false,
    "claude-historian": {
      "search_before_web": false,
      "search_before_plan": false,
      "search_before_task": false,
      "search_after_error": false
    }
  }
}
```

| Key | Default | What It Controls |
|-----|---------|-----------------|
| `search_before_web` | `true` | Check history before web research |
| `search_before_plan` | `true` | Search past plans before planning |
| `search_before_task` | `true` | Check tool patterns before launching agents |
| `search_after_error` | `true` | Suggest error solutions after command failures |
| `suggest_siblings` | `true` | Show install suggestions for sibling plugins (global) |

## How It Works

Hooks inject prompts that trigger `claude-historian-mcp` tools at high-impact moments. If relevant history exists, Claude reuses it. If not, it proceeds silently.

Typical savings: 200-800 tokens per avoided redundant search.

## License

MIT

© vvkmnn · MIT · Vvkmnn/claude-emporium

Similar plugins

All plugins for Notes, tasks and projects →

From the same set20

The whole set →
claude-orator claude-orator scores prompts across seven dimensions and returns a reworked version. Use it to shape subagent requests or review prompts across a session. CX Codex +1 ★ 78repo stars claude-historian claude-historian — a skill that automatically searches past sessions before triggering web research, planning, or debugging. Reuse past solutions across projects and avoid redundant work. CX Codex +1 ★ 78repo stars claude-gladiator claude-gladiator tracks tool failures, collects observations, and prompts reflection to update rules and skills at session end. It helps the agent learn from its own mistakes. CX Codex +1 ★ 78repo stars claude-orator claude-orator is a Claude Code plugin that scores and restructures prompts before they go to subagents. Its hook suggests a rewrite for underspecified Task prompts. ★ 78repo stars claude-vigil claude-vigil creates file snapshots before destructive operations, shows what changed, and restores safely. Protection against accidental deletion or overwriting. ★ 78repo stars claude-gladiator claude-gladiator is a Claude Code plugin that catches tool failures and prompts reflection before sessions close. ★ 78repo stars claude-oracle claude-oracle searches 17 sources for skills, plugins, and MCP servers. It can look for relevant tools before planning or after a command error. ★ 78repo stars claude-praetorian claude-praetorian triggers prompts to save and reload session context around planning, web research, and subagent runs, reducing token usage by 50-60%. ★ 78repo stars

Project sponsors

Companies that keep this analytics open