| name | peek |
| description | Searches memories and displays compact one-liner results, or looks up a specific memory by ID. Use for quick memory lookups, checking if a decision was recorded, resolving [mem0:id] citations, or browsing memories without full category detail. |
Mem0 Peek
Quick search with compact output. Lighter than /mem0:tour.
Execution
Step 1: Parse query
The user provides a search query: /mem0:peek auth middleware
If no query provided, ask: "What should I search for?"
Memory ID detection: If the query matches any of these patterns, treat it as a
direct memory ID lookup instead of a search:
- Bare hex:
^[a-f0-9]{8}$ (short ID) or ^[a-f0-9]{8}-[a-f0-9-]+$ (full UUID)
- Citation ref:
[mem0:<hex>] — extract the hex portion
When an ID is detected:
- Call
get_memory(<id>) directly (if short ID, try as prefix of full UUID)
- If found, skip to Step 3 and display the single result
- If not found, fall through to search using the ID as query text
Step 2: Search
Run 2 parallel search_memories calls:
- Broad:
query=<user's query>, filters={"AND": [{"user_id": "<id>"}, {"app_id": "<pid>"}]}, top_k=10, rerank=true
- Targeted:
query=<user's query>, filters={"AND": [{"user_id": "<id>"}, {"app_id": "<pid>"}, {"metadata": {"type": "decision"}}]}, top_k=5, rerank=true
Step 3: Display
Deduplicate by ID, then show compact results:
## mem0 peek: "<query>" (<N> results)
1. [decision] Auth module uses JWT with RS256 keys (2025-05-15) [mem0:a3f8b2c1]
2. [anti_pattern] Don't use symmetric HS256 — leaked in env (2025-05-10) [mem0:7e2d9f4a]
3. [convention] All middleware in src/middleware/ (2025-05-08) [mem0:c4d5e6f7]
Format: <number>. [<type>] <content, 80 chars> (<date>) [mem0:<short_id>]
If no results:
No memories matching "<query>" for project <project_id>.
