claude-historian — плагин для Claude Code: поиск в истории сессий
Плагин claude-historian автоматически проверяет прошлые сессии перед веб-поиском, планированием и отладкой. Помогает избежать повторной работы и найти уже готовые решения.
MIT ★ 78 обновлён 2026-03-05
/plugin marketplace add Vvkmnn/claude-emporium
/plugin install claude-historian@claude-emporiumЧто делает claude-historian
claude-historian работает через хуки, которые срабатывают в критические моменты: перед веб-поиском, запуском режима планирования, вызовом агентов и после ошибок команд. Если в истории найдётся релевантный результат, Claude его переиспользует; если нет — продолжает работу без задержек.
Плагин опирается на MCP-сервер claude-historian-mcp и предоставляет семь инструментов поиска: общий поиск по сессиям, поиск похожих вопросов, извлечение решений ошибок, отслеживание изменений файлов, обнаружение успешных паттернов работы, просмотр недавних сессий и поиск по планам реализации. Все четыре основных хука включены по умолчанию, но их можно отключить в ~/.claude/settings.json под ключом claude-historian.
Экономия обычно составляет 200–800 токенов за каждый избежанный повторный поиск.
Какие задачи решает
- найти решение ошибки из прошлой сессии
- вспомнить, как решалась похожая задача
- избежать повторного веб-поиска по одному и тому же вопросу
- обнаружить успешные паттерны работы в истории
- отследить изменения конкретного файла в прошлых сессиях
Примеры запросов агенту
- Поиск решение ошибки
404 not foundв истории прошлых сессий - /search-historian как организовать кэширование в react
- Покажи, какие планы реализации я делал для нового API
Как установить claude-historian
Через маркетплейс плагинов
/plugin marketplace add Vvkmnn/claude-emporium/plugin install claude-historian@claude-emporiumПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о claude-historian
Как установить claude-historian в Claude Code?
Выполни две команды подряд: сначала /plugin marketplace add Vvkmnn/claude-emporium, затем /plugin install claude-historian@claude-emporium. Убедись, что установлен MCP-сервер: claude mcp add historian -- npx claude-historian-mcp.
Что делает claude-historian?
Плагин автоматически проверяет историю твоих сессий перед веб-поиском, планированием и отладкой. Если найдёт релевантный результат, предложит его переиспользовать вместо повторной работы.
Какие требования для работы плагина?
Нужен MCP-сервер claude-historian-mcp, который устанавливается командой claude mcp add historian -- npx claude-historian-mcp. Без него плагин не будет функционировать.
Исходный текст
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