mem0-scope

name	mem0-scope
description	Views or changes the default memory scope (project, session, or global) used when saving and searching memories. Use when the user wants to control whether memories are scoped to this repo, this run, or shared across all their projects.

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)
   

   Put [active] next to the current scope. If you fetched a count in step 2, add a Memories in scope: <N> line.

Step 3: Change mode — set a new scope

1. Validate the target is one of project, session, global. If not, show the three options and stop.

2. Read the existing settings so you preserve every other key. Use the Read tool on ~/.mem0/settings.json (it may not exist yet — treat a missing file as {}).

3. Write the file back with the Write tool, keeping ALL existing keys and only setting "default_scope" to the target. Pretty-print with 2-space indent and a trailing newline. Do not drop global_search, dream, auto_save, or any other field that was present.

   Example resulting file (when other keys already existed):

   {
     "auto_save": true,
     "search_limit": 10,
     "default_scope": "global"
   }
   

4. Confirm:

   Default memory scope changed: <old> -> <new>
   
   <one line describing the effect — see below>
   Applies immediately to memory tools in this session.
   
   To revert: /mem0-scope <old>
   

   Effect lines:

   • project → "New memories and searches are limited to this repo."
   • session → "New memories and searches are limited to this run (this conversation)."
   • global → "New memories and searches span all your projects. delete_all_memories still needs an explicit scope=global to delete user-wide."

Notes

• This only changes the default. Any memory tool call can still pass an explicit scope to override it for that one call.
• delete_all_memories deliberately ignores the default scope: deleting user-wide always requires an explicit scope="global", so changing the default can never turn a routine cleanup into a cross-project wipe.
• global scope (this user, all their projects) is distinct from the separate global_search setting (all users). Leave global_search untouched here.

Output formatting

IMPORTANT: Do NOT use markdown in your output. OpenCode TUI renders text verbatim — markdown like bold, ## headers, and | table | syntax appears as raw characters. Use plain text with indentation for structure. Use dashes for lists. Use spaces to align columns instead of markdown tables.