remember
Search through past conversation histories to recall previous discussions, decisions, and context. Use when you need to reference what was discussed or decided in previous sessions.
When & Why to Use This Skill
The 'remember' skill provides a powerful search mechanism for Claude to access and retrieve information from past conversation histories. By indexing local project logs, it enables the agent to recall specific decisions, technical explanations, and historical context, ensuring continuity across multiple sessions and preventing the loss of critical project knowledge.
Use Cases
- Recalling Design Decisions: Quickly locate the reasoning behind specific architectural choices or project directions discussed in previous sessions.
- Retrieving Code Explanations: Find detailed breakdowns of complex logic or functions that were previously explained to maintain a consistent understanding of the codebase.
- Tracking Feature History: Search for discussions related to specific modules (e.g., 'networking' or 'combat system') to understand how a feature has evolved over time.
- Contextual Troubleshooting: Reference past debugging sessions and error resolutions to solve recurring issues without repeating the same diagnostic steps.
- Project Continuity: Seamlessly pick up where a previous session left off by searching for the last decided tasks or milestones.
| name | remember |
|---|---|
| description | Search through past conversation histories to recall previous discussions, decisions, and context. Use when you need to reference what was discussed or decided in previous sessions. |
Conversation History Search
Search through past conversation histories stored in ~/.claude/projects/*/*.jsonl to help recall previous discussions, decisions, code explanations, and context from earlier sessions.
Instructions
Run the search command with a query string:
uv run python .claude/skills/remember/remember.py "<query>"Optionally include agent conversations (sub-tasks):
uv run python .claude/skills/remember/remember.py "<query>" --include-agents
Features
- Searches both user and assistant messages
- Finds discussions about specific topics, features, or files
- Shows conversation context with timestamps
- Groups results by session for easy navigation
- Sorts by recency (most recent first)
- Skips agent conversations by default (use
--include-agentsto include them) - Case-insensitive substring matching
Examples
Search for discussions about networking:
uv run python .claude/skills/remember/remember.py "networking"
Find conversations about a specific file:
uv run python .claude/skills/remember/remember.py "DESIGN.md"
Look for combat system discussions:
uv run python .claude/skills/remember/remember.py "combat system"
Search including agent conversations:
uv run python .claude/skills/remember/remember.py "ENet" --include-agents
When to Use This Skill
- Need to recall why a design decision was made
- Want to find previous discussions about a feature
- Looking for context about how something was implemented
- Trying to remember what was decided in a past conversation
- Need to reference code explanations from earlier sessions
Notes
- Searches conversation histories in
~/.claude/projects/*/ - By default, excludes agent conversations (background tasks)
- Results are truncated to 200 characters for readability
- Shows file path and line number for reference
- Groups results by session to see conversation flow
- Displays up to 50 most recent matches by default