mem0-scope

Mem0 Scope

View or change the default memory scope — the scope the memory tools use when no explicit scope is given. The setting persists in ~/.mem0/settings.json (default_scope) and the plugin reads it fresh on each memory operation, so a change takes effect immediately in the current session.

The three scopes:

• project (default) — this repo only. Filters by user_id + app_id.
• session — this run only. Adds run_id (the current session) so memories are isolated to this conversation.
• global — across ALL your projects. Reads use app_id="*"; writes drop app_id so the memory is user-wide.

Execution

Step 1: Determine intent

Look at the user's message for a target scope word: project, session, or global (also accept "repo"→project, "run"→session, "all"/"everywhere"→global).

• No target word present → View mode (Step 2).
• A target word present → Change mode (Step 3).

Step 2: View mode — show the current scope

1. Read the current default scope from settings:

   _S="$HOME/.mem0/settings.json"
   [ -f "$_S" ] && grep -o '"default_scope"[[:space:]]*:[[:space:]]*"[a-z]*"' "$_S" | grep -o '[a-z]*"$' | tr -d '"' || echo "project"
   

   If the command prints nothing, the scope is project (the default).

2. (Optional) Show how many memories live in the current scope by calling get_memories with scope="<current>", page_size=1, and reading the count (or result length) from the response.

3. Display using the identity the plugin exported (do NOT re-shell git):

   Mem0 memory scope
   
   Current default scope: <current>
   
     project  - this repo only (user + app_id)        <marker if active>
     session  - this run only (adds run_id)           <marker if active>
     global   - all your projects (app_id = *)         <marker if active>
   
   User:    ${MEM0_USER_ID}
   Project: ${MEM0_APP_ID}
   Session: ${MEM0_SESSION_ID}
   
   To change: /mem0-scope session    (or project / global)