troubleshoot

Diagnoses and fixes rad-mem installation and runtime issues in PM2 workers, databases, and ports.

7|4|Updated Nov 27, 2025
One-click install
npx skills add https://github.com/thedotmack/rad-mem --skill troubleshoot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: troubleshoot
Source: https://github.com/thedotmack/rad-mem/tree/main/plugin/skills/troubleshoot
Command: npx skills add https://github.com/thedotmack/rad-mem --skill troubleshoot

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires node.js, pm2, sqlite3, curl, and includes scripts (resource) components.

What problem does it solves?

Users often encounter installation, configuration, or operational issues with plugins, leading to frustration and lost productivity. Manually debugging complex systems like claude-mem can be daunting. This Skill automates the diagnostic and fixing process, getting you back to work faster.

Core Features & Use Cases

  • Comprehensive Diagnostics: Checks PM2 worker status, database integrity, service health, dependencies, and port conflicts.
  • Automated Fixes: Provides one-command solutions for common problems like worker not starting, missing dependencies, or port conflicts.
  • Guided Troubleshooting: Offers step-by-step workflows for specific symptoms like "Nothing is remembered" or "Viewer is empty."
  • Use Case: If Claude-Mem isn't remembering anything, simply invoke the troubleshoot skill and it will guide you through diagnostics or even apply an automated fix, getting you back to work quickly.

Quick Start

My Claude-Mem isn't remembering anything. Please troubleshoot.

Frequently Asked Questions about troubleshoot

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

FAQPage Schema
How do I troubleshoot Claude-Mem when it stops remembering things?

Troubleshoot Claude-Mem by running automated diagnostics that check PM2 worker status, database integrity, service health, and dependencies. The Skill identifies issues like memory not persisting after /clear, corrupted data, or failed workers, then applies targeted fixes or guides you through resolution steps.

Can I diagnose PM2 worker and database issues without manual debugging?

Yes. This Skill automates diagnosis of PM2-based workers and SQLite database problems, checking process status, data corruption, port conflicts, and missing dependencies. It provides one-command fixes for common failures like workers not starting or port conflicts.

What happens when the Claude-Mem viewer is empty or won't load?

The Skill runs comprehensive health checks on service endpoints, database records, and worker processes to identify why the viewer is empty or failing to load. It diagnoses missing data, API endpoint failures, and worker issues, then applies automated fixes or step-by-step guidance.

How do I fix port conflicts or missing dependencies in Claude-Mem setup?

Use the Skill's diagnostic workflow to detect port conflicts and dependency gaps affecting Claude-Mem installation. It checks Node.js, pm2, sqlite3, and curl availability, identifies conflicts, and applies automated solutions to restore functionality.

Does this Skill work with PM2-based plugin installations?

Yes. The Skill targets PM2-managed workers and SQLite databases, making it suitable for Claude-Mem and similar PM2-based plugin systems. It covers worker startup failures, database health, service checks, and dependency validation specific to PM2 deployments.

What should I do before running troubleshooting diagnostics?

Ensure Node.js, pm2, sqlite3, and curl are installed on your system. The Skill's dependency checks will verify these prerequisites, but having them available beforehand enables faster diagnostics and automated fixes for Claude-Mem runtime issues.