Wisely

Monitoring & reports

Wisely includes a RAM monitoring system that runs in the background via the Windows Task Scheduler, with no terminal window required.

Starting and stopping monitoring requires administrator rights — run PowerShell as Administrator for the -Monitor start and -Monitor stop commands.

RAM monitoring

# Start monitoring
wisely -Monitor start
# Check status
wisely -Monitor status
# Stop monitoring
wisely -Monitor stop

Behavior

  • Checks WSL2's RAM usage (via the vmmem process) every 30 seconds
  • Sends a native Windows Toast alert if usage crosses the configured threshold (80% by default)
  • Built-in cooldown: at least 30 minutes between two consecutive alerts

The threshold and check interval are configurable in data/profiles.json (the settings key).

Weekly reports

A usage report is generated automatically every Monday at 9am system local time, via the Windows Task Scheduler, enabled when monitoring starts.

# Generate a report manually
wisely -Report

Report contents

  • Time breakdown by profile
  • The dominant profile of the week
  • Peak usage time
  • A list of the most recent switches

Reports are saved to data/reports/report_YYYY-MM-DD.txt. Up to 12 reports are kept, with automatic rotation.

# Clean up manually
wisely -Clean