memories.sh logomemories.sh
CLI Reference

memories compact

Run inactivity compaction worker routines for active sessions.

memories compact run [options]

Run background compaction for active sessions based on inactivity thresholds.

memories compact run

OptionDescription
--inactivity-minutes <n>Session inactivity threshold in minutes (default: 60)
--limit <n>Maximum sessions to process per run (default: 25)
--event-window <n>Number of recent meaningful events included in checkpoint summaries (default: 8)
--jsonOutput as JSON

Examples

memories compact run
memories compact run --inactivity-minutes 30 --limit 50 --event-window 12
memories compact run --json

Notes

  • This worker scans active sessions and compacts those past the inactivity threshold.
  • JSON output includes scan/compaction counts and any per-session failures.

On this page