check-health

User Input

$ARGUMENTS

Goal

Perform a health check of the memory system using the built-in memory validate command. Supports all 4 scope levels: User, Project, Local, and Enterprise.

Prerequisites

CRITICAL: Before running any memory commands, you MUST activate the memory skill first using the Skill tool:

Skill: memory

This ensures the skill is loaded and the memory CLI command is available (installed via bun link). Without this step, the commands below may not work correctly.

Execution Steps

1. Determine Scope

Check arguments first:

• --user or --global or user or global → Use user scope
• --project or project → Use project scope
• --local or local → Use local scope
• --enterprise or enterprise → Use enterprise scope (for managed environments)
• --all or all → Check all accessible scopes sequentially
• quick or --quick → Quick check mode (can combine with any scope)

Note: --global is accepted as a legacy alias for --user.

If no scope provided, first check which scopes are accessible:

# Check enterprise scope availability (for managed environments)
memory config get scopes.enterprise.enabled 2>/dev/null | jq -r '.data // false'

# Check if in a git repo (for project/local scopes)
git rev-parse --git-dir >/dev/null 2>&1 && echo "in_git_repo"

Then use AskUserQuestion with available options:

{
  "question": "Which memory scope would you like to check?",
  "header": "Memory scope",
  "options": [
    {"label": "User", "description": "Personal cross-project memories in ~/.claude/memory/"},
    {"label": "Project", "description": "Shared project memories in .claude/memory/ (tracked in git)"},
    {"label": "Local", "description": "Personal project memories in .claude/memory/local/ (gitignored)"},
    {"label": "All accessible", "description": "Check all accessible scopes sequentially"}
  ],
  "multiSelect": false
}

Dynamic options:

• Only show "Project" and "Local" if in a git repository
• Always show "User" and "All accessible"
• Enterprise scope is supported but not shown by default (pass --enterprise explicitly)