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

1. Be specific: Search for error messages, tool names, or specific technologies
2. Use project context: Filter by project when looking for project-specific knowledge
3. Check skills first: Skills contain distilled, high-quality knowledge
4. 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.