Observability tier: - /mem0:stats: session + lifetime memory dashboard with category breakdown - /mem0:health: 5-check diagnostic (API key, identity, MCP, write/read, tracker) - /mem0:digest: weekly memory activity summary with time-scoped searches - session_stats.py: add `peek` command (JSON without clearing), per-category counters
77 lines
2.0 KiB
Markdown
77 lines
2.0 KiB
Markdown
---
|
|
name: mem0-stats
|
|
description: >
|
|
Show memory statistics for the current session and project lifetime.
|
|
Combines local session counters with API-fetched totals.
|
|
TRIGGER: user runs /mem0:stats, or asks "how many memories", "mem0 stats",
|
|
"memory usage", "show memory count".
|
|
---
|
|
|
|
# Mem0 Stats
|
|
|
|
Show session and lifetime memory statistics.
|
|
|
|
## Execution
|
|
|
|
### Step 1: Gather session stats
|
|
|
|
Run the session stats reporter:
|
|
|
|
```bash
|
|
SCRIPT_DIR="${CLAUDE_PLUGIN_ROOT:-${CODEX_PLUGIN_ROOT:-${CURSOR_PLUGIN_ROOT:-}}}/scripts"
|
|
python3 "$SCRIPT_DIR/session_stats.py" peek 2>/dev/null || echo "{}"
|
|
```
|
|
|
|
The `peek` command returns JSON without clearing the stats file (unlike `report`).
|
|
|
|
If the script returns empty or errors, note "No session data available" and continue.
|
|
|
|
### Step 2: Fetch lifetime stats from API
|
|
|
|
Call `get_memories` with:
|
|
- `user_id=<active_user_id>`
|
|
- `app_id=<active_project_id>`
|
|
- `page_size=100`
|
|
|
|
Count the returned memories. Group them by:
|
|
1. `categories[0]` (platform-assigned) — primary grouping
|
|
2. `metadata.type` (agent-assigned) — secondary if no categories
|
|
3. `created_at` date — for age analysis
|
|
|
|
Also run a `search_memories` call with `query="project"`, `limit=1` to measure round-trip latency (time the call).
|
|
|
|
### Step 3: Display
|
|
|
|
Print a compact dashboard:
|
|
|
|
```
|
|
## mem0 Stats
|
|
|
|
### This Session
|
|
Memories written: <N>
|
|
Searches run: <N>
|
|
Categories touched: <list>
|
|
|
|
### Project Lifetime (<project_id>)
|
|
Total memories: <N>
|
|
By category:
|
|
Architecture Decisions: <N>
|
|
Anti-Patterns: <N>
|
|
Task Learnings: <N>
|
|
Coding Conventions: <N>
|
|
User Preferences: <N>
|
|
Tooling & Setup: <N>
|
|
Session State: <N>
|
|
Other: <N>
|
|
Oldest memory: <date>
|
|
Newest memory: <date>
|
|
|
|
### Health
|
|
API latency: <N>ms
|
|
User: <user_id>
|
|
Project: <project_id>
|
|
Branch: <branch>
|
|
```
|
|
|
|
Skip any section with zero data. Don't show empty categories.
|