GOG Stale Games Cleanup

Scan your GOG library for installed games not played in 30+ days, email the list, and add Apple Reminders for each. One-command game cleanup workflow.

Find installed GOG games you haven't played in 30+ days, email yourself a summary, and create Apple Reminders so you can decide whether to uninstall.

When to Use

• User says "clean up my GOG library", "stale games", "games I haven't played", "uninstall reminder"
• Running a periodic game-library audit
• Triggered by cron for monthly cleanup reminders

Quick Start

bash

bash scripts/sweep.sh \
  --library /path/to/gog_library.json \
  --days 30 \
  --email personal \
  --reminders-list Gaming

Parameters

Flag	Default	Description
--library	config/gog_library.json	Path to GOG library JSON
--days	30	Stale threshold in days
--email	personal	Himalaya account name for sending
--reminders-list	Gaming	Apple Reminders list name
--dry-run	off	Print actions without sending email or creating reminders

What It Does

1. Reads your GOG library JSON
2. Filters for installed: true games whose last_played is older than the threshold (or null)
3. Sends an HTML email via himalaya with the stale game list
4. Adds one Apple Reminder per stale game to the specified list

Output Example

text

🧹 GOG Stale Games Sweep — 2026-05-12
  Found 2 stale games (>30 days since last play):

  • Stardew Valley — last played 2026-03-28
  • Cyberpunk 2077 — never played

  ✉️  Email sent to [e-mail]
  📝 2 reminders added to "Gaming" list

Configuration

GOG Library JSON

See references/gog_library_schema.json for the expected format. Each game needs:

• name (string)
• installed (boolean)
• last_played (ISO 8601 datetime or null)

Himalaya

See references/himalaya.toml.example. The script uses himalaya template send on the account specified by --email.

Apple Reminders

The list specified by --reminders-list is created if it doesn't exist (remindctl list <name> --create).

Cron Integration

Run monthly:

bash

# Add via OpenClaw cron — monthly on the 1st at 10:00
openclaw cron add --name "gog-stale-sweep" \
  --schedule "0 10 1 * *" \
  --command "bash /path/to/scripts/sweep.sh --library /path/to/gog_library.json"

Or use the agent's cron tool with a systemEvent payload that triggers this skill.