GOG Cleanup
/install gog-cleanup
GOG Cleanup
Automated stale-game cleanup sweep: finds installed GOG games you haven't played in 30+ days, emails you a digest, and creates Apple Reminders so you can decide whether to uninstall.
What It Does
- Reads your GOG library from
config/gog_library.json - Filters for installed games whose
last_playedis 30+ days ago (or never played) - Sends a formatted digest email via
himalaya - Adds each stale game to the Gaming list in Apple Reminders via
remindctl
Prerequisites
| Tool | Purpose | Install |
|---|---|---|
jq |
JSON parsing | brew install jq |
himalaya |
Send email | brew install himalaya |
remindctl |
Apple Reminders | brew install steipete/tap/remindctl |
- Himalaya must be configured with a
personalaccount (seeconfig/himalaya.toml) - Apple Reminders must have a Gaming list (auto-created if missing)
Usage
Run the full sweep (email + reminders)
bash scripts/gog-cleanup.sh
Email only (skip reminders)
SKIP_REMINDERS=1 bash scripts/gog-cleanup.sh
Reminders only (skip email)
SKIP_EMAIL=1 bash scripts/gog-cleanup.sh
Custom stale threshold (default 30 days)
STALE_DAYS=60 bash scripts/gog-cleanup.sh
Custom recipient (defaults to himalaya personal account email)
EMAIL_TO="[email protected]" bash scripts/gog-cleanup.sh
Configuration
The script reads from workspace config/:
| File | Purpose |
|---|---|
config/gog_library.json |
GOG game library with install status & last_played timestamps |
config/himalaya.toml |
Himalaya email account config (uses personal account) |
config/reminders_lists.json |
Reminders list structure (Gaming list) |
Output
- Email: HTML-formatted digest sent to your personal inbox
- Reminders: One reminder per stale game in the Gaming list, prefixed with "🧹 Consider uninstalling:"
- Console: Summary of games found and actions taken
Scheduling
To run weekly via cron:
# Add to crontab for Monday 9 AM
0 9 * * 1 /path/to/scripts/gog-cleanup.sh >> /tmp/gog-cleanup.log 2>&1
Or use OpenClaw's cron tool for agent-managed scheduling.
Notes
- Games with
last_played: null(never played) are always included - Uninstalled games are always skipped regardless of last_played
- The script is idempotent — re-running won't duplicate reminders (existing reminders with the same title are skipped)
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install gog-cleanup - 安装完成后,直接呼叫该 Skill 的名称或使用
/gog-cleanup触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
GOG Cleanup 是什么?
Find GOG games installed but not played for 30+ days, email the list, and add Apple Reminders to consider uninstalling. One-command cleanup sweep for your ba... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 47 次。
如何安装 GOG Cleanup?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install gog-cleanup」即可一键安装,无需额外配置。
GOG Cleanup 是免费的吗?
是的,GOG Cleanup 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
GOG Cleanup 支持哪些平台?
GOG Cleanup 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 GOG Cleanup?
由 terrycarter1985(@terrycarter1985)开发并维护,当前版本 v1.0.0。