User-Space Scheduler Guidelines
Codify scheduled workflows to automate maintenance tasks across macOS and Linux without root privileges.
π Declarative Task Definition
- Tasks are defined declaratively as JSON files specifying
name,schedule(hourly, daily, weekly), andcommand. - Do not make assumptions about the strict directory location where the final JSON task definitions are stored.
βοΈ Service Registration
- macOS (launchd): Register user plists inside
~/Library/LaunchAgents/using modernlaunchctl bootstrap/bootout. - Linux (systemd): Register user service and timer files inside
~/.config/systemd/user/and manage withsystemctl --user.
π Logging & Maintenance
- macOS (launchd): Redirection (
>) in the launchd program arguments to truncate logs on every run and prevent infinite disk growth. - Linux (systemd): Standardize logging via
StandardOutput=journaland query viajournalctl --user.
π Templates
Templates for macOS launchd and Linux systemd configurations are stored inside the skill's templates/ directory as reusable example files.