basemind 0.21.1

Full AI context layer over MCP — tree-sitter code-map, document RAG (PDF/Office/HTML/email + OCR + reranker), shared agent memory, on-demand web crawl, git history + blame + per-symbol diff. 300+ languages, 10+ coding-agent harnesses, content-addressed Fjall + LanceDB.
---
name: bm-stats
description: Show the basemind dashboard — resource footprint (disk + RAM) and activity (tool calls, per-tool histogram, estimated tokens saved). Works with or without the MCP server.
argument-hint: [today|1h|24h|all]
---

# bm-stats — basemind dashboard

Show a basemind dashboard with two sections: resource footprint (on-disk size + process RAM) and
activity (tool calls, per-tool histogram, estimated tokens saved).

## When to use

The user asks "how much is basemind helping?", "show me basemind stats", or wants to check disk /
RAM usage.

## How to use

Invoke `/bm-stats` (default window `today`) or `/bm-stats <today|1h|24h|all>`. Window: $ARGUMENTS

1. **Resource footprint.** MCP tool `cache_stats`, or CLI `basemind cache stats` (add `--json` to
   parse). Report: `total_bytes` (matches `du`), the per-component breakdown (blobs / views /
   git-history / lance / git-cache / telemetry / other), and process RAM (`rss_bytes` +
   `peak_rss_bytes`). If `blob_accounting_ok` is `false`, note that orphan accounting was skipped
   (stale/unreadable index — re-scan to restore it); the sizes are still accurate.

2. **Activity.** MCP tool `telemetry_summary`, or CLI `basemind telemetry --window <today|1h|24h|all>`
   (add `--json`). Report call count, the per-tool histogram, and estimated tokens saved for the
   window.

3. **Render** both sections as a compact markdown dashboard.

## Notes

- Prefer the MCP tools when connected, but don't depend on them — the CLI reads the same data
  with no server. If a step's MCP tool isn't available, run its CLI equivalent instead of giving up.
- If neither MCP nor CLI is reachable, say so plainly and point at `/bm-doctor`.
- Always end with a one-sentence disclosure that the savings number is heuristic: tools without a
  realistic baseline (memory, document search, git wrappers) report 0 saved.

## See also

The `basemind-stats` skill for the render shape and the `--explain` breakdown.