mem-search
Search through past session context and observations. Use when asking about past work, previous implementations, how something was done before, or recalling decisions. Keywords: remember, recall, last time, before, history, what did we, how did we
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
Memory Search - Cross-Session Context
Overview
Search through stored observations from past Claude Code sessions. Use this skill when the user asks about:
- "What did we do last session?"
- "How did we implement X before?"
- "What bugs did we fix recently?"
- "What decisions were made about Y?"
- "Show me recent work on this project"
How to Use
Run the search command to query the context memory database:
python3 "$CLAUDE_PROJECT_DIR/.claude/memory/context_memory.py" search "<query>"
Common Queries
Recent activity:
python3 "$CLAUDE_PROJECT_DIR/.claude/memory/context_memory.py" recent
Search for specific topic:
python3 "$CLAUDE_PROJECT_DIR/.claude/memory/context_memory.py" search "authentication"
Get statistics:
python3 "$CLAUDE_PROJECT_DIR/.claude/memory/context_memory.py" stats
Get full context for current branch:
python3 "$CLAUDE_PROJECT_DIR/.claude/memory/context_memory.py" context "branch-name"
Observation Types
The memory stores these types of observations:
| Type | Symbol | Description |
|---|---|---|
| decision | D | Choices made about architecture, tools, approaches |
| bugfix | B | Bug fixes and error resolutions |
| feature | F | New features implemented |
| refactor | R | Code refactoring and cleanup |
| discovery | i | Information discovered during exploration |
| change | C | General code changes |
Database Location
The context memory is stored at: ~/.claude/context_memory.duckdb
Response Format
When presenting search results:
- Group by type (decisions, bugfixes, features, etc.)
- Show most recent first
- Include timestamp and branch if relevant
- Summarize rather than dump raw data
Example Response
"Based on context memory, here's what happened:
Recent Decisions:
- [2 days ago] Chose DuckDB over SQLite + Chroma for context storage
- [3 days ago] Adopted tiered context injection strategy
Recent Bugfixes:
- [Yesterday] Fixed authentication timeout in API routes
Recent Features:
- [Today] Implemented context memory hooks"
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-26
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!