name: claudeception-memory description: | Search through Claude Code session memories and learned skills. Use when: (1) you need to find how a similar problem was solved before, (2) looking for relevant skills or knowledge, (3) checking if there's existing context about a project or technology, (4) the user asks "have we done this before?" or "what do you remember about X?". Triggers on: memory search, recall, remember, past sessions, history, previous work. author: Claude Code version: 1.0.0 date: 2025-01-22 triggers:

"search memory"
"what do you remember"
"have we done this before"
"recall"
"past sessions"
"check history"
"find similar"

Claudeception Memory Search

Search through recorded Claude Code session histories and extracted skills to find relevant past knowledge.

When to Use

Before starting a task, check if similar work was done before
When debugging, see if similar errors were encountered and solved
When the user asks about past sessions or previous work
To find relevant skills that might help with the current task

How to Search

Quick Memory Search

Search for any term across all memories and skills:

~/.claude/hooks/memory-search.sh "search term"

Search Recent Sessions Only

Limit to the last N days:

~/.claude/hooks/memory-search.sh "search term" --recent 7

Search Specific Project

Filter by project directory:

~/.claude/hooks/memory-search.sh "search term" --project "project-name"

List Recent Sessions

See summary of recent activity:

~/.claude/hooks/memory-search.sh

Memory Locations

Session Logs: ~/.claude/sessions/YYYY-MM-DD/*.jsonl - Raw event logs
Memory Index: ~/.claude/memory/*.json - Processed session summaries
Skills: ~/.claude/skills/*/SKILL.md - Extracted knowledge as skills

What Gets Recorded

Each session records:

User prompts (truncated for storage)
Tools used and their frequency
Errors encountered
Working directory context
Session timing

Search Tips

Be specific: Search for error messages, tool names, or specific technologies
Use project context: Filter by project when looking for project-specific knowledge
Check skills first: Skills contain distilled, high-quality knowledge
Recent is relevant: Most valuable context is usually recent

Example Searches

# Find past work with Remotion
~/.claude/hooks/memory-search.sh "remotion"

# Find sessions with database errors
~/.claude/hooks/memory-search.sh "database error"

# Find recent Next.js work
~/.claude/hooks/memory-search.sh "next.js" --recent 14

# Find work in a specific project
~/.claude/hooks/memory-search.sh "auth" --project "cosplit"

Integration with Claudeception

This skill works alongside the claudeception skill:

claudeception extracts new knowledge into skills
claudeception-memory retrieves existing knowledge

Together they form a continuous learning loop where discoveries are preserved and can be retrieved when relevant.

claudeception-memory

SKILL.md