tour

Mem0 Project Tour

Show the user what mem0 has stored for the current project.

Cross-project mode

When invoked with --all-projects (e.g., /mem0:tour --all-projects or /mem0:tour --all-projects auth middleware), search across ALL projects:

1. Call get_memories with filters={"AND": [{"user_id": "<active_user_id>"}]}, page_size=200 — no app_id filter.
2. If a search query was also provided, run search_memories with query=<query>, filters={"AND": [{"user_id": "<active_user_id>"}]}, top_k=20 — again no app_id.
3. Group results by app_id first, then by category within each project.
4. Display:

   ## <app_id_1> (<N> memories) ← current
   **Architecture Decisions** — <memory content>
   ...
   
   ## <app_id_2> (<N> memories)
   ...
   
   <N> memories across <M> projects
   

5. Mark the current project with ← (current) in the heading.

If --all-projects is NOT present, use the standard single-project flow below.

Peek mode (compact search)

When /mem0:tour receives a search query argument (e.g., /mem0:tour auth middleware) WITHOUT --all-projects, run in peek mode — compact one-liner results:

1. Run 2 parallel search_memories calls:
   • Broad: query=<query>, filters={"AND": [{"user_id": "<id>"}, {"app_id": "<pid>"}]}, top_k=10, rerank=true
   • Targeted: query=<query>, filters={"AND": [{"user_id": "<id>"}, {"app_id": "<pid>"}, {"metadata": {"type": "decision"}}]}, top_k=5, rerank=true
2. Deduplicate by ID, display compact results:

   ## mem0 search: "<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>]
3. If no results: No memories matching "<query>" for project <project_id>.

If no query argument and no --all-projects flag, use the full tour flow below.

Execution

Step 1: Fetch ALL memories for this project

Call get_memories to fetch all memories for this project:

filters={"AND": [{"user_id": "<active_user_id>"}, {"app_id": "<active_project_id>"}]}, page_size=100

Step 2: Run supplementary semantic searches

In parallel, run these search_memories calls to get relevance-ranked results for key topics:

• query="architecture decisions design choices", filters={"AND": [{"user_id": "<id>"}, {"app_id": "<pid>"}]}, top_k=10, rerank=true
• query="bugs errors failures anti-patterns", filters={"AND": [{"user_id": "<id>"}, {"app_id": "<pid>"}]}, top_k=10, rerank=true
• query="project setup tooling conventions preferences", filters={"AND": [{"user_id": "<id>"}, {"app_id": "<pid>"}]}, top_k=10, rerank=true

Do NOT filter by metadata.type in these calls. The platform auto-assigns categories — filtering on metadata.type misses memories that were auto-categorized but don't have an explicit metadata.type.

Step 3: Merge and group

Merge all results by memory ID (deduplicate). For each memory, determine its group using this priority:

1. Platform categories field (array on each memory, auto-assigned by Mem0). Use the first category value.
2. metadata.type field (if present, set explicitly by hooks/agent). Use as fallback if no categories.
3. "other" bucket for memories with neither.

Map category names to display names:

Platform category / metadata.type	Display name
architecture decisions, architecture_decisions, decision	Architecture Decisions
anti patterns, anti_patterns, anti_pattern	Anti-Patterns
task learnings, task_learnings, task_learning	Task Learnings
coding conventions, coding_conventions, convention	Coding Conventions
user preferences, user_preferences, user_preference	User Preferences
project profile, project_profile	Project Profile
tooling setup, tooling_setup, environmental	Tooling & Setup
technology, professional_details	Tooling & Setup
session_state	Session State
compact_summary	Compact Summaries
anything else	Other

Step 4: Display results

Sort groups by descending memory count. For each group that has results, print:

## <display_name> (<count> memories)
- <full_memory_content> (score: <similarity_score_if_available>)
- ...

Show the full memory text for each entry — do NOT truncate. If a group has more than 10 entries, show top 10 by recency (or similarity score if from a search call) and note ... and <N> more.

For groups with zero results, skip them entirely — don't print empty groups.

Step 5: Print totals

<N> memories across <M> categories — project: <project_id>, branch: <active_branch>

Step 6: Empty state

If zero memories found for this project, print:

No memories stored yet for project <project_id>.
Run /mem0:onboard to import project files, or start working — mem0 captures learnings automatically.