Mem0 Local Admin

Use the local mem0-admin CLI for deterministic analysis and guarded mutation. Keep the existing lightweight prompt hook as the ordinary recall path.

Scope

Resolve the active project to the literal basename of the current working directory and pass it with --app-id unless the user explicitly requests a user-wide operation. Never send a request to api.mem0.ai.

Modes

• Deep context: run mem0-admin context "<task>" --app-id "<project>" and present only relevant results.
• Review: run mem0-admin review --app-id "<project>". This is read-only. Treat near-duplicate output as candidates, not facts; contradictions always require human judgment.
• Forget: first run mem0-admin forget "<query>" --app-id "<project>". Show the candidates and ask the user to approve one exact memory ID. Only then run mem0-admin forget --id "<id>" --yes.
• Dream preview: run mem0-admin dream --dry-run --app-id "<project>". Show the plan path, action count, reasons, backup/recovery implications, and ask for approval.
• Dream apply: only after approval of that exact plan, run mem0-admin dream --apply "<plan>" --yes.
• Bounded auto mode is for a human-operated interactive terminal only. Never pass --yes; the command prints its exact plan and requires the human to type confirmation before applying at most ten eligible actions.

Safety boundary