mem-search
Search persistent cross-session memory to answer questions about previous work and past solutions.
- Three-layer workflow: search for IDs and metadata (50–100 tokens per result), optionally view timeline context around interesting results, then batch-fetch full details only for filtered IDs
- Search parameters include query text, project name, observation type (bugfix, feature, decision, discovery, change), and date range filtering
- Timeline tool shows observations, sessions, and prompts interleaved chronologically around an anchor point to understand context
- Batch
get_observationscall retrieves complete details (500–1000 tokens each) for multiple IDs in a single request, avoiding N individual fetches
Memory Search
Search past work across all sessions. Simple workflow: search -> filter -> fetch.
When to Use
Use when users ask about PREVIOUS sessions (not current conversation):
- "Did we already fix this?"
- "How did we solve X last time?"
- "What happened last week?"
3-Layer Workflow (ALWAYS Follow)
NEVER fetch full details without filtering first. 10x token savings.
Step 1: Search - Get Index with IDs
Use the search MCP tool:
More from thedotmack/claude-mem
smart-explore
Token-optimized structural code search using tree-sitter AST parsing. Use instead of reading full files when you need to understand code structure, find functions, or explore a codebase efficiently.
2.5Kmake-plan
Create a detailed, phased implementation plan with documentation discovery. Use when asked to plan a feature, task, or multi-step implementation — especially before executing with do.
2.5Kdo
Execute a phased implementation plan using subagents. Use when asked to execute, run, or carry out a plan — especially one created by make-plan.
2.5Ktimeline-report
Generate a "Journey Into [Project]" narrative report analyzing a project's entire development history from claude-mem's timeline. Use when asked for a timeline report, project history analysis, development journey, or full project report.
2.2Kclaude-code-plugin-release
Automated semantic versioning and release workflow for Claude Code plugins. Handles version increments across package.json, marketplace.json, plugin.json manifests, npm publishing (so `npx claude-mem@X.Y.Z` resolves), build verification, git tagging, GitHub releases, and changelog generation.
1.6Kknowledge-agent
Build and query AI-powered knowledge bases from claude-mem observations. Use when users want to create focused "brains" from their observation history, ask questions about past work patterns, or compile expertise on specific topics.
1.4K