debug-memory

Diagnoses ClaudeMemory installation and configuration issues.

23|1|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/codenamev/claude_memory --skill debug-memory
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-memory
Source: https://github.com/codenamev/claude_memory/tree/main/skills/debug-memory
Command: npx skills add https://github.com/codenamev/claude_memory --skill debug-memory

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose ClaudeMemory installation and configuration issues.

Core Features & Use Cases

  • Diagnostics of global and project memory databases, schemas, and hooks
  • Guidance to remediate setup and connectivity problems
  • Quick path to verify and restore memory health in claude-memory workflows

Quick Start

Run the debug-memory command to start diagnostics and view results.

Frequently Asked Questions about debug-memory

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose ClaudeMemory setup issues when memory tools fail?

To diagnose ClaudeMemory setup issues when memory tools fail, run the debug-memory command to validate databases, schemas, hooks, CLAUDE.md imports, snapshot status, and ingest activity. It detects configuration problems and guides remediation to restore memory health.

Why does my claude-memory database appear unhealthy after installation?

Your claude-memory database may appear unhealthy due to broken schemas, invalid hook configurations, or missing CLAUDE.md imports. Running diagnostics validates database integrity and identifies the specific configuration issue requiring remediation.

What is the best way to check claude-memory hooks and database health?

The best way to check claude-memory hooks and database health is by running a diagnostic command that validates global and project memory databases, verifies hook configurations, and checks ingest activity to pinpoint setup or connectivity problems.

How do I validate CLAUDE.md imports and snapshot status for memory workflows?

To validate CLAUDE.md imports and snapshot status for memory workflows, execute the debug-memory diagnostics. It checks import configurations and snapshot integrity, then provides guided steps to restore memory health if issues are detected.

Can I use debug diagnostics to fix broken claude-memory configuration?

Yes, you can use debug diagnostics to fix broken claude-memory configuration. It applies when memory tools fail or setup seems broken, validating databases and hooks while providing targeted guidance to remediate connectivity and configuration problems.

Do I need any dependencies to run claude-memory diagnostics?

No dependencies are required to run claude-memory diagnostics. The diagnostic tool operates independently to validate databases, schemas, hooks, and CLAUDE.md imports, then guides you through remediation without external package requirements.