Overview
Add documentation for running cache-cleaner tools on a schedule (launchd on macOS, cron on Linux/macOS) so users can automate weekly or monthly cleanup. Covers all content previously in [mac-cache-cleaner] issue #56 Part 5.
Implementation Plan
-
Location
- Add
docs/scheduling.md or extend README with "Scheduled Runs" section
-
Content
- launchd (macOS):
- Plist example for weekly run of
mac-cache-cleaner --clean --yes
- Install:
launchctl load ~/Library/LaunchAgents/com.cache-cleaner.weekly.plist
- Log location
- cron:
0 3 * * 0 = weekly Sunday 3am
- Example crontab with log redirection:
0 3 * * 0 /usr/local/bin/mac-cache-cleaner --clean --yes >> ~/cache-cleaner.log 2>&1
- Example for dev-cache:
dev-cache --scan ~/src --clean --yes
- Example for git-cleaner:
git-cleaner --scan ~/src --clean
- Example for mac-cache-cleaner:
mac-cache-cleaner --clean --yes
- brew services: If applicable, document how to run periodically via Homebrew
- Recommendations:
- Run during low-usage hours (e.g. overnight or weekend)
- Ensure PATH includes tool binaries
- Log output for debugging
Acceptance Criteria
Overview
Add documentation for running cache-cleaner tools on a schedule (launchd on macOS, cron on Linux/macOS) so users can automate weekly or monthly cleanup. Covers all content previously in [mac-cache-cleaner] issue #56 Part 5.
Implementation Plan
Location
docs/scheduling.mdor extend README with "Scheduled Runs" sectionContent
mac-cache-cleaner --clean --yeslaunchctl load ~/Library/LaunchAgents/com.cache-cleaner.weekly.plist0 3 * * 0= weekly Sunday 3am0 3 * * 0 /usr/local/bin/mac-cache-cleaner --clean --yes >> ~/cache-cleaner.log 2>&1dev-cache --scan ~/src --clean --yesgit-cleaner --scan ~/src --cleanmac-cache-cleaner --clean --yesAcceptance Criteria