Background memory consolidation cycle. Scans memory files, finds stale/duplicate/conflicting entries, consolidates, synthesizes cross-session insights, builds an injection-ready payload for next session start, and writes a dated dream report.

When to invoke

User says "run dream", "consolidate memories", "clean up memories", "memory maintenance", "deduplicate memories"
Cron job at 2 AM nightly via wrapper script: scripts/auto-dream-cron.sh --execute
Manual trigger for testing: ./scripts/auto-dream-cron.sh (dry-run by default)

Reference Loading Table

Signal	Load These Files	Why
Debugging failed cron run, silent failure, empty log, wrong exit code	`headless-cron-patterns.md`	Routes to the matching deep reference
Setting up or modifying wrapper script (`flock`, `--permission-mode`, `envsubst`, `PIPESTATUS`)	`headless-cron-patterns.md`	Routes to the matching deep reference
Budget cap, `--max-budget-usd`, unattended Claude invocation	`headless-cron-patterns.md`	Routes to the matching deep reference
Writing, updating, or archiving memory files	`memory-file-operations.md`	Routes to the matching deep reference
Updating `MEMORY.md` index, atomic write, `.tmp` rename	`memory-file-operations.md`	Routes to the matching deep reference
Staleness detection, duplicate merging, conflict flagging	`memory-file-operations.md`	Routes to the matching deep reference
YAML frontmatter structure, `merged_from`, memory file format	`memory-file-operations.md`	Routes to the matching deep reference

auto-dream

When to invoke

Reference Loading Table

More from notque/claude-code-toolkit

generate-claudemd

fish-shell-config

pptx-generator

codebase-overview

image-to-video

data-analysis