GOG Cleanup Reminder

Use this skill when the user wants a repeatable cleanup workflow for their installed GOG library.

What it does

• Reads a GOG library JSON export
• Selects games where:
  • installed == true
  • last_played is at least 30 days ago
• Emails the stale installed-game list to the configured personal email account
• Adds one Apple Reminder per stale game to the Gaming list

Default config inputs

This skill is designed to work with the workspace config files already present in this environment:

• GOG library: config/gog_library.json
• Himalaya mail config: config/himalaya.toml
• Apple Reminders list name: Gaming

Main script

python3 scripts/gog_cleanup_reminder.py --dry-run --print-json

Real run

python3 scripts/gog_cleanup_reminder.py

Common options

python3 scripts/gog_cleanup_reminder.py --days 45
python3 scripts/gog_cleanup_reminder.py --list Gaming
python3 scripts/gog_cleanup_reminder.py --email-account personal
python3 scripts/gog_cleanup_reminder.py --allow-no-play-history
python3 scripts/gog_cleanup_reminder.py --skip-email
python3 scripts/gog_cleanup_reminder.py --skip-reminders

Notes

• himalaya must be installed and able to send mail for the chosen account.
• remindctl must be installed on macOS and authorized to access Apple Reminders.
• The script will create the target reminders list if needed.
• By default, installed games with last_played = null are ignored to avoid noisy reminders. Use --allow-no-play-history if you want those included.

Output behavior

• If no matching games are found, the script exits successfully and reports that there is nothing to clean up.
• On success, it sends exactly one summary email and creates one reminder per matching game.
• --dry-run shows the email body without sending mail or creating reminders.