| name | fleet-scan |
| description | Scan ALL mem0 app_ids at once — per-app memory count, noise ratio (session_summary and friends), junk app_id candidates (JUNK? flag), and app/user_id fragmentation pairs. Read-only, deterministic script, zero LLM cost. Use when the user asks for a mem0-wide overview, 'which projects are noisy', 'mem0 전체 점검', or before a cleanup round. Per-project quality (duplicates inside one app) belongs to the upstream mem0 plugin's memory-reviewer instead. |
fleet-scan
Hermes/Codex note
Script is plain python3 on all runtimes. On Hermes, Bash maps to
terminal. Codex 0.135 does NOT export CLAUDE_PLUGIN_ROOT — always
resolve PLUGIN_ROOT first (block below).
Steps
-
Resolve the plugin root (cross-runtime), then run the scan:
PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-}"
[ -z "$PLUGIN_ROOT" ] && [ -d plugins/mem0-ops/scripts ] && PLUGIN_ROOT=plugins/mem0-ops
if [ -z "$PLUGIN_ROOT" ]; then
cache_root="${CODEX_PLUGIN_CACHE:-$HOME/.codex/plugins/cache}"
PLUGIN_ROOT=$(ls -1d "$cache_root"/*/mem0-ops/* 2>/dev/null | sort | tail -1)
fi
[ -d "$PLUGIN_ROOT/scripts" ] || { echo "mem0-ops scripts not found"; exit 1; }
python3 "$PLUGIN_ROOT/scripts/fleet_scan.py"
- Requires
MEM0_API_KEY; the script exits with guidance if unset.
- Full-fleet scan pages every app — expect ~1-2 minutes on large stores.
-
Interpret the report for the user:
JUNK? flag = basename-style name + noise >= 90% + zero manual types.
These are cwd-fallback artifacts; suggest cleanup --app <name> --all.FRAG pairs = same project split across two app_ids (recall is split).
Merge is out of scope v1 — report only.- High noise% on a real project = suggest
cleanup --app <name> --type session_summary.
-
Do NOT delete anything from this skill. Route to the cleanup skill.
