gc

Memory

Search first: /mnemonic:search {relevant_keywords} Capture after: /mnemonic:capture {namespace} "{title}"

Run /mnemonic:list --namespaces to see available namespaces from loaded ontologies.

/mnemonic:gc

Garbage collect expired memories based on TTL and decay, with optional compression.

Arguments

• --dry-run - Show what would be removed without removing
• --archive - Move to archive instead of deleting
• --force - Skip confirmation prompts
• --min-strength - Minimum strength threshold (default: 0.1)
• --max-age - Maximum age in days (default: 365)
• --compress - Compress large old memories before archiving
• --compress-only - Only compress, don't archive/delete
• --compress-threshold - Minimum lines for compression (default: 100)

Procedure

Step 1: Parse Arguments

DRY_RUN="${DRY_RUN:-false}"
ARCHIVE="${ARCHIVE:-true}"
FORCE="${FORCE:-false}"
MIN_STRENGTH="${MIN_STRENGTH:-0.1}"
MAX_AGE="${MAX_AGE:-365}"

ORG=$(git remote get-url origin 2>/dev/null | sed -E 's|.*[:/]([^/]+)/[^/]+\.git$|\1|' | sed 's|\.git$||')
[ -z "$ORG" ] && ORG="default"

ARCHIVE_DIR="$HOME/.claude/mnemonic/.archive/$(date +%Y-%m)"

Step 2: Find Candidates

By Age

echo "=== Finding GC Candidates ==="
echo ""

echo "Old memories (> $MAX_AGE days):"
OLD_FILES=$(find "$HOME/.claude/mnemonic/$ORG" "./.claude/mnemonic" -name "*.memory.md" -mtime +$MAX_AGE 2>/dev/null)
OLD_COUNT=$(echo "$OLD_FILES" | grep -c . 2>/dev/null || echo 0)
echo "  Found: $OLD_COUNT"

By TTL Expiry

echo ""
echo "Expired TTL:"
NOW=$(date +%s)
TTL_EXPIRED=""

for f in $(find "$HOME/.claude/mnemonic/$ORG" "./.claude/mnemonic" -name "*.memory.md" 2>/dev/null); do
    TTL=$(grep "^  ttl:" "$f" 2>/dev/null | sed 's/.*ttl: //')
    CREATED=$(grep "^created:" "$f" 2>/dev/null | sed 's/created: //')

    if [ -n "$TTL" ] && [ -n "$CREATED" ]; then
        # Parse TTL (simplified - handles P{N}D format)
        TTL_DAYS=$(echo "$TTL" | sed 's/P\([0-9]*\)D/\1/')
        if [ -n "$TTL_DAYS" ]; then
            # Calculate if expired (simplified check via file mtime)
            FILE_AGE=$(( ( NOW - $(stat -f %m "$f" 2>/dev/null || stat -c %Y "$f" 2>/dev/null) ) / 86400 ))
            if [ "$FILE_AGE" -gt "$TTL_DAYS" ]; then
                TTL_EXPIRED="$TTL_EXPIRED $f"
                echo "  $f (TTL: ${TTL_DAYS}d, Age: ${FILE_AGE}d)"
            fi
        fi
    fi
done

TTL_COUNT=$(echo "$TTL_EXPIRED" | wc -w | tr -d ' ')
echo "  Total: $TTL_COUNT"