Alex Newman
db3794762f
* fix: export/import scripts now use API instead of direct DB access Export script fix: - Add format=json parameter to SearchManager for raw data output - Add getSdkSessionsBySessionIds method to SessionStore - Add POST /api/sdk-sessions/batch endpoint to DataRoutes - Refactor export-memories.ts to use HTTP API Import script fix: - Add import methods to SessionStore with duplicate detection - Add POST /api/import endpoint to DataRoutes - Refactor import-memories.ts to use HTTP API 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com> * fix: update analyze-transformations-smart.js to use bun:sqlite Replace better-sqlite3 import with bun:sqlite to align with v7.1.0 migration. * chore: remove all better-sqlite3 references from codebase - Updated scripts/analyze-transformations-smart.js to use bun:sqlite - Merged PR #332: Refactored import/export scripts to use worker API instead of direct DB access - Updated PM2-to-Bun migration documentation All better-sqlite3 references have been removed from source code. Documentation references remain as appropriate historical context. * build: update plugin artifacts with merged changes Include built artifacts from PR #332 merge and analyze-transformations-smart.js update. --------- Co-authored-by: lee <loyalpartner@163.com> Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
3.2 KiB
3.2 KiB
name, description
| name | description |
|---|---|
| troubleshoot | Diagnose and fix claude-mem installation issues. Checks worker status, database integrity, service health, dependencies, and provides automated fixes for common problems. |
Claude-Mem Troubleshooting Skill
Diagnose and resolve installation and operational issues with the claude-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?
- "Nothing is being remembered" → operations/common-issues.md
- "Viewer is empty" → operations/common-issues.md
- "Worker won't start" → operations/common-issues.md
- "Want to run full diagnostics" → operations/diagnostics.md
- "Need automated fix" → operations/automated-fixes.md
Available Operations
Choose the appropriate operation file for detailed instructions:
Diagnostic Workflows
- Full System Diagnostics - Comprehensive step-by-step diagnostic workflow
- Worker Diagnostics - Bun worker-specific troubleshooting
- Database Diagnostics - Database integrity and data checks
Issue Resolution
- Common Issues - Quick fixes for frequently encountered problems
- Automated Fixes - One-command fix sequences
Reference
- Quick Commands - Essential commands for troubleshooting
Quick Start
Fast automated fix (try this first):
cd ~/.claude/plugins/marketplaces/thedotmack/ && \
npm run worker:stop; \
npm install && \
npm run worker:start && \
sleep 3 && \
curl -s http://127.0.0.1:37777/health
Expected output: {"status":"ok"}
If that doesn't work, proceed to detailed diagnostics.
Response Format
When troubleshooting:
- Identify the symptom - What's the user reporting?
- Choose operation file - Use the decision guide above
- Follow steps systematically - Don't skip diagnostic steps
- Report findings - Tell user what you found and what was fixed
- Verify resolution - Confirm the issue is resolved
Technical Notes
- Worker port: Default 37777 (configurable via
CLAUDE_MEM_WORKER_PORT) - Database location:
~/.claude-mem/claude-mem.db - Plugin location:
~/.claude/plugins/marketplaces/thedotmack/ - Worker PID file:
~/.claude-mem/worker.pid
Error Reporting
If troubleshooting doesn't resolve the issue, collect diagnostic data and direct user to: https://github.com/thedotmack/claude-mem/issues
See operations/diagnostics.md for details on what to collect.