Node.js Path

Use the Node.js absolute path from your context's "Node.js Path" section (injected by the plugin on every prompt). If not available in context, fall back to node.

Script Path Resolution

IMPORTANT: The scripts/ folder is in the plugin directory, NOT the current project.

From "Base directory for this skill:" above, derive the scripts path:

Remove /skills/clear-memory from the end
Add /scripts/ to get the scripts directory

Example: if Base directory is ~/.claude/plugins/cache/.../skills/clear-memory, then Scripts path is derived by removing /skills/clear-memory and appending /scripts/.

Use this full path when running node commands below.

Project Root Resolution

IMPORTANT: Get the project root from your context's "Project Root Anchor" section. Look for: Your ACTUAL project root is: <path>

Use this value as {PROJECT_DIR} in all commands below. If not available in context, use your current working directory.

Clear Memory

Clean up old session files.

Usage

/crabshell:clear-memory [all|old]

Actions

Archive old files (recommended):

Use full path from above:

"{NODE_PATH}" "{SCRIPTS_PATH}/counter.js" compress --project-dir="{PROJECT_DIR}"

This archives session files older than 30 days into monthly archives:

sessions/2025-10-15_0300.md -> sessions/archive/2025-10.md

Clear everything (manual):

WARNING: Destructive operation

# Remove all session files (use Node to avoid sensitive file permission prompts)
"{NODE_PATH}" -e "const fs=require('fs'),p=require('path'),d='{PROJECT_DIR}/.crabshell/memory/sessions';fs.readdirSync(d).filter(f=>f.endsWith('.md')||f.endsWith('.jsonl')).forEach(f=>fs.unlinkSync(p.join(d,f)));console.log('sessions cleared')"

# Optionally clear logbook.md
"{NODE_PATH}" -e "try{require('fs').unlinkSync('{PROJECT_DIR}/.crabshell/memory/logbook.md');console.log('logbook.md deleted')}catch(e){console.log('not found')}"

Recommendations

Regular maintenance: Run compress monthly
Before major changes: Create backup first

Notes

compress is non-destructive (archives, doesn't delete)
Archived files can be manually reviewed in sessions/archive/