mcpField
P
peek

peek

github.com/mem0aiAgent workflows68.0k105 installsUpdated 2d ago
Repository

About peek

peek is a Mem0 skill for quickly searching project memories and displaying compact results. It also recognizes memory IDs for direct lookup.

Key features

  1. 01Searches project memories
  2. 02Runs broad and decision-focused searches
  3. 03Reranks search results
  4. 04Looks up memories by ID
  5. 05Displays deduplicated compact results

Use cases

  1. 01Quickly find a project decision
  2. 02Look up a memory from its ID
  3. 03Search project notes for a topic

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/mem0ai/mem0 --skill peek

After installing, type/peekin Claude Code to confirm it loaded.

Details

From the project README

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:

  1. Call get_memory(<id>) directly (if short ID, try as prefix of full UUID)
  2. If found, skip to Step 3 and display the single result
  3. If not found, fall through to search using the ID as query text
Step 2: Search

Run 2 parallel search_memories calls:

  1. Broad: query=<user's query>, filters={"AND": [{"user_id": "<id>"}, {"app_id": "<pid>"}]}, top_k=10, rerank=true
  2. 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>.

Comments

Markdown supported