Skip to main content

Stats

ContextCrumb logs local token-savings events by default.

View stats:

contextcrumb stats

JSON:

contextcrumb stats --json

Recent window:

contextcrumb stats --since 24h
contextcrumb stats --since 7d
contextcrumb stats --since 4w

Shareable one-liner:

contextcrumb stats --share

Reset the ledger:

contextcrumb stats reset

Privacy Controls​

Disable stats for one command:

contextcrumb load notes.md --no-stats

Disable stats globally:

CONTEXTCRUMB_STATS=0 contextcrumb load notes.md

Choose how paths are recorded:

CONTEXTCRUMB_STATS_PATH_MODE=basename contextcrumb load notes.md
CONTEXTCRUMB_STATS_PATH_MODE=full contextcrumb load notes.md
CONTEXTCRUMB_STATS_PATH_MODE=hash contextcrumb load notes.md
CONTEXTCRUMB_STATS_PATH_MODE=none contextcrumb load notes.md

Default path mode is basename.

Use a custom stats file:

CONTEXTCRUMB_STATS_FILE=/tmp/contextcrumb-stats.jsonl contextcrumb load notes.md

Recorded Fields​

Each event includes:

  • timestamp
  • run id
  • source
  • command
  • redacted source path
  • input tokens
  • kept tokens
  • deleted tokens
  • token keep ratio
  • mode
  • model id
  • backend