/recall-status

Show memory system health — word counts, stale entries, hook status, recommendations.

davegoldblatt@davegoldblatt

GitHub

From plugin

recall See the plugin

20010 skills10 commands2 hooks

shell

$ npx -y skills add davegoldblatt/total-recall --skill recall-status --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.
You can call itInvoke it directly when you want it.
Slash command/recall-status

How auto-invocation works

Context preview

The summary Claude sees to decide when to auto-load this skill.

Show memory system health — word counts, stale entries, hook status, recommendations.

SKILL.md

recall-status.SKILL.md

description: Show memory system health — word counts, stale entries, hook status, recommendations.

Show the health and status of the memory system.

What To Do

1. Check Memory System Exists

If CLAUDE.local.md and memory/ directory don't exist:

Memory system not initialized. Run /recall-init to set up.

2. Gather Metrics

**CLAUDE.local.md (Working Memory):**

Word count (target: under 1500)
Last updated date
Number of open loops listed

**Daily Logs (memory/daily/):**

Total number of files
Date range (oldest to newest)
Total size
Entries in last 7 days

**Registers (memory/registers/):**

Number of register files
Total size
Count entries with `last_verified` dates older than 30 days (stale)
Count entries marked `[superseded]`

**Archive (memory/archive/):**

Number of files
Total size

**Entry IDs (memory/.recall/metadata.json):**

Count entries with `^tr` IDs (tagged) vs without (untagged) across managed files (CLAUDE.local.md, registers, archive)
Count metadata.json entries total
Count pinned entries
Count snoozed entries (with active snooze)
Count superseded entries

**Hooks:**

Check .claude/settings.json or .claude/settings.local.json for SessionStart and PreCompact hook config

3. Display Status

Memory System Status
────────────────────

Working Memory:  [N] words ([N]% of 1500 limit)
  (CLAUDE.local.md)  Last updated: [date]
                     Open loops: [N]

Protocol:        .claude/rules/total-recall.md ✓
Schema:          memory/SCHEMA.md ✓

Daily logs:      [N] files, [size] total
                 Range: [oldest] → [newest]
                 Last 7 days: [N] entries

Registers:       [N] files, [size] total
                 Stale entries (>30 days): [N]
                 Superseded entries: [N]

Archive:         [N] files, [size] total

Entry IDs:       [N] tagged / [M] untagged
                 metadata.json: [N] entries
                 Pinned: [N], Snoozed: [N], Superseded: [N]

Hooks:
  SessionStart   [✓ configured / ✗ not configured]
  PreCompact     [✓ configured / ✗ not configured]

4. Recommendations

Based on metrics, suggest actions:

If working memory > 1200 words: "Working memory approaching limit — consider archiving stale items"
If stale entries > 0: "Run /recall-maintain to verify [N] stale entries"
If no daily log in 3+ days: "No recent daily logs — memory capture may have gaps"
If open loops > 5: "Consider reviewing open loops — some may be resolved"
If registers are empty: "Registers are empty — use /recall-promote to populate from daily logs"
If working memory stale (7+ days): "Working memory may be stale — review for accuracy"
If hooks not configured: "Consider configuring SessionStart/PreCompact hooks for automated memory loading and flush"
If untagged entries > 0: "Run /recall-init-ids to tag [N] untagged entries (required for /recall-maintain)"
If superseded entries in metadata > 0: "Run /recall-maintain to clean up [N] superseded entries"