Claude session memory search

--- 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: ``bash ~/.claude/hooks/memory-search.sh "search term" ` ### Search Recent Sessions Only Limit to the last N days: `bash ~/.claude/hooks/memory-search.sh "search term" --recent 7 ` ### Search Specific Project Filter by project directory: `bash ~/.claude/hooks/memory-search.sh "search term" --project "project-name" ` ### List Recent Sessions See summary of recent activity: `bash ~/.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 `bash # 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.