본문으로 건너뛰기
cccskills
무료GitHub에 공개

troubleshoot

Diagnose and fix rad-mem installation issues. Checks PM2 worker status, database integrity, service health, dependencies, and provides automated fixes for common problems.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

설치 방법 보기

포함된 파일(7)

  • SKILL.md3.2 KB
  • operations/automated-fixes.md3.3 KB
  • operations/common-issues.md5.6 KB
  • operations/database.md8.0 KB
  • operations/diagnostics.md6.6 KB
  • operations/reference.md3.2 KB
  • operations/worker.md5.9 KB

SKILL.md(원문)

설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.

Rad-Mem Troubleshooting Skill

Diagnose and resolve installation and operational issues with the rad-mem plugin.

When to Use This Skill

Invoke this skill when:

  • Memory not persisting after /clear
  • Viewer UI empty or not loading
  • Worker service not running
  • Database missing or corrupted
  • Port conflicts
  • Missing dependencies
  • "Nothing is remembered" complaints
  • Search results empty when they shouldn't be

Do NOT invoke for feature requests or usage questions (use regular documentation for that).

Quick Decision Guide

Once the skill is loaded, choose the appropriate operation:

What's the problem?

Available Operations

Choose the appropriate operation file for detailed instructions:

Diagnostic Workflows

  1. Full System Diagnostics - Comprehensive step-by-step diagnostic workflow
  2. Worker Diagnostics - PM2 worker-specific troubleshooting
  3. Database Diagnostics - Database integrity and data checks

Issue Resolution

  1. Common Issues - Quick fixes for frequently encountered problems
  2. Automated Fixes - One-command fix sequences

Reference

  1. Quick Commands - Essential commands for troubleshooting

Quick Start

Fast automated fix (try this first):

cd ~/.claude/plugins/marketplaces/thedotmack/ && \
pm2 delete rad-mem-worker 2>/dev/null; \
npm install && \
node_modules/.bin/pm2 start ecosystem.config.cjs && \
sleep 3 && \
curl -s http://127.0.0.1:38888/health

Expected output: {"status":"ok"}

If that doesn't work, proceed to detailed diagnostics.

Response Format

When troubleshooting:

  1. Identify the symptom - What's the user reporting?
  2. Choose operation file - Use the decision guide above
  3. Follow steps systematically - Don't skip diagnostic steps
  4. Report findings - Tell user what you found and what was fixed
  5. Verify resolution - Confirm the issue is resolved

Technical Notes

  • Worker port: Default 37777 (configurable via CLAUDE_MEM_WORKER_PORT)
  • Database location: ~/.rad-mem/rad-mem.db
  • Plugin location: ~/.claude/plugins/marketplaces/thedotmack/
  • PM2 process name: rad-mem-worker

Error Reporting

If troubleshooting doesn't resolve the issue, collect diagnostic data and direct user to: https://github.com/thedotmack/rad-mem/issues

See operations/diagnostics.md for details on what to collect.

리뷰

아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.

댓글

로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.

아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.

보내면 바로 공개됩니다. 이메일 주소나 전화번호 같은 개인 정보는 쓰지 마세요. URL은 2개까지입니다.

0 / 1,000자

이 양식은 reCAPTCHA로 보호되며 Google 개인정보처리방침 및 서비스 약관이 적용됩니다.

같은 저장소의 스킬

Search rad-mem's persistent cross-session memory database. Use when user asks "did we already solve this?", "how did we do X last time?", or needs work from previous sessions.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

thedotmack/rad-mem72026년 10월 6일 업데이트

Manage semantic version updates for rad-mem project. Handles patch, minor, and major version increments following semantic versioning. Updates package.json, marketplace.json, plugin.json, and CLAUDE.md version number (NOT version history). Creates git tags and GitHub releases. Auto-generates CHANGELOG.md from releases.

한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.

thedotmack/rad-mem72026년 10월 6일 업데이트

thedotmack의 스킬 모두 보기

이 스킬의 문제 신고