/claude-historian

name: claude-historian
description: Use before WebSearch to check if you already have the answer, when stuck on an error to find past fixes, or when entering a familiar project to recall past sessions and file changes.

Claude Historian

Search conversation history before starting fresh. You may already have the answer.

When to Use

**Before WebSearch** → `search(query: "...", scope: "similar")` or `search(query: "...", scope: "conversations")`. Past solutions beat web results.

**Stuck on an error** → `search(query: "<error message>", scope: "errors")`. Finds past fixes with code.

**Entering a familiar project** → `search(scope: "sessions")` for recent work. `search(query: "...", scope: "plans")` for past decisions.

**Working on a familiar file** → `search(scope: "files", filepath: "src/index.ts")`. Shows past changes with context.

Quick Reference

| Situation | Tool Call | |-----------|----------| | Error with no obvious cause | `search(query: "<error>", scope: "errors")` | | "Have I done this before?" | `search(query: "...", scope: "similar")` | | Working on familiar file | `search(scope: "files", filepath: "...")` | | Need past design reasoning | `search(query: "...", scope: "plans")` | | What did I do last session? | `search(scope: "sessions")` | | Successful tool workflows | `search(scope: "tools")` | | General search | `search(query: "...", scope: "conversations")` | | Deep-dive into session | `inspect(session_id: "...")` | | Rules, skills, CLAUDE.md | `search(query: "...", scope: "config")` | | Task management history | `search(query: "...", scope: "tasks")` | | Memories across sessions | `search(query: "...", scope: "memories")` |

Key Parameters

• **`scope`**: Target your search — `conversations`, `errors`, `files`, `plans`, `config`, `tasks`, `similar`, `sessions`, `tools`, `memories`, or `all` (default)
• **`limit`**: Number of results (default 10)
• **`project`**: Filter by project name substring (works with conversations, sessions)
• **`timeframe`**: `today`, `yesterday`, `week`, `month`

Common Mistakes

| Mistake | Fix | |---------|-----| | Going straight to WebSearch | Check historian first — past solutions are more relevant | | Vague queries | Use specific terms: error messages, file paths, tool names | | Using `scope: "all"` for errors | Use `scope: "errors"` — it has dedicated fix extraction | | Long keyword-dump queries | Keep to 3-5 specific terms, not 10+ generic ones |