# Stats

> Show MemMesh usage stats for a project/user — total count and breakdowns by type, scope, and status, plus the oldest/newest timestamps. Use when checking "how many memories do I have", auditing distribution before a cleanup, or giving a quick health read.

- Skill: `thinkfleetai/stats` (Agent Skill)
- Install (CLI): `npx skillmds@latest add thinkfleetai/stats`
- Raw SKILL.md: https://api.skillmd.com/api/skills/thinkfleetai/stats/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: thinkfleetai (https://skillmd.com/u/thinkfleetai)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/thinkfleetai/stats

---


# stats

Summarize what's in memory.

```jsonc
{ "name": "memory_stats", "arguments": { "projectId": "<repo>" } }
```

Scope it with `projectId` / `userId` / `scope`; omit for everything under the
platform. Returns `total`, `byType`, `byScope`, `byStatus`, `oldest`, `newest`,
and `scanCapped` (true if the count hit the scan limit — raise `limit` for an
exact number on very large stores).

## Present it

Lead with the total, then the type breakdown (the useful one), then flag health
signals:
- a large `superseded` / `rejected` share ⇒ suggest `dream` (consolidation).
- approaching the free-tier 500-item cap ⇒ mention it and suggest `forget`/`dream`.

For a per-subject picture (not aggregate counts) use `context-loader`.