claudeception-memory

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-22T00:00:00.000Z"
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.