What problem does it solve?
macOS launchd (launchctl) job management for repository-scoped automations. Install, uninstall, list, status, reload, and kick jobs defined under the current repo's .launchd/jobs/*.plist.tmpl by rendering templates and placing them in ~/Library/LaunchAgents, enabling per-project scheduling.
Core Features & Use Cases
- Template-driven deployment: renders .plist.tmpl templates into LaunchAgents with token substitution ({{REPO_PATH}}, {{LABEL}}, {{HOME}}, {{USER}}) for deterministic, repeatable setups.
- Lifecycle management: supports install, uninstall, list, status, reload, and kick actions to manage per-repo jobs across macOS systems.
- Safe governance: validates rendered plist with plutil, prompts for user confirmation on destructive actions, and uses bootstrap/bootout semantics to avoid leftover loads in edge cases.
Quick Start
Install all defined launchd jobs by rendering templates from .launchd/jobs and bootstrapping them with launchctl.