fleet-scan

fleet-scan

Codex note

Script is plain python3 on all runtimes. Codex 0.135 does NOT export CLAUDE_PLUGIN_ROOT: always resolve PLUGIN_ROOT first (block below).

Steps

1. Resolve the plugin root (cross-runtime), then run the scan:

   PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-}"
   [ -z "$PLUGIN_ROOT" ] && [ -d plugins/wiki/scripts ] && PLUGIN_ROOT=plugins/wiki
   if [ -z "$PLUGIN_ROOT" ]; then
     cache_root="${CODEX_PLUGIN_CACHE:-$HOME/.codex/plugins/cache}"
     PLUGIN_ROOT=$(ls -1d "$cache_root"/*/wiki/* 2>/dev/null | sort | tail -1)
   fi
   [ -d "$PLUGIN_ROOT/scripts" ] || { echo "wiki scripts not found"; exit 1; }
   # Interpreter detection — python3 alone breaks python.org Windows installs; validate
   # the candidate really is Python 3 (a python->python2 alias would die on f-strings)
   PY=""; for c in python3 python "py -3"; do
     if $c -c 'import sys; raise SystemExit(0 if sys.version_info[0] == 3 else 1)' >/dev/null 2>&1; then PY=$c; break; fi
   done
   [ -n "$PY" ] || { echo "no Python 3 interpreter found (tried python3, python, py -3)"; exit 1; }
   $PY "$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.

2. 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.

3. Do NOT delete anything from this skill. Route to the cleanup skill.

Config posture (absorbed from doctor)

When the user asks about local mem0 configuration ('mem0 설정 점검', hook timeouts, rerank) rather than fleet contents, run the posture check. Shell state does not persist across tool calls, so this block re-resolves PLUGIN_ROOT and the interpreter itself: