scheduled-jobs
Schedule and debug local jobs with systemd timers or macOS launchd.
Install
npx skills add https://github.com/fmind/dot/tree/main/skills/scheduled-jobs
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install fmind-dot@llmmart
git clone https://github.com/fmind/dot.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole fmind/dot collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
Scheduled Jobs
Schedule bounded commands via native user schedulers and verify triggered runs (python-script owns scripts; mise owns tasks).
Workflow
- Pick the native scheduler: Linux user timers or macOS LaunchAgents (keep existing project schedulers unless migrating; host skills own harness-native schedules).
- Version definitions in the owning repo: invoke an absolute executable path with locked dependencies and a single-writer lock; enable only after the user approves the schedule and recurring effects.
- Prove a real timer-triggered run and its application outcome (manual runs or enabled units alone are partial proof).
Owner conventions
fmind/dotuser units: store indot_config/systemd/user/, enable viatimers.target.wantssymlinks, and register unit hashes inrun_onchange_after_systemd-user-reload.sh.tmpl(systemctl --user daemon-reloadon apply).- Never restart the
agydaemon during apply: it may host the active Remote Control session, so the reload hook only prints the restart command.
Gotchas
- Stay in user space: never use
sudo, system units, orloginctl enable-lingerunasked; note if requested availability exceeds logged-in sessions. - Handle missed or timed-out runs explicitly: choose skip vs coalesce deliberately and reconcile current state before re-running mutations.
Documentation
Files (dot)
-
references
-
linux.md 2.4 KB
Loading… -
macos.md 2.2 KB
Loading…
-
-
SKILL.md 2 KB
--- name: scheduled-jobs description: "Schedule and debug local jobs with systemd timers or macOS launchd." license: MIT metadata: kind: task author: Médéric HURIER (Fmind) source: github.com/fmind/dot/tree/main/skills/scheduled-jobs created: "2026-09-09" updated: "2026-11-10" --- # Scheduled Jobs Schedule bounded commands via native user schedulers and verify triggered runs ([python-script](../python-stack/references/python-script/GUIDE.md) owns scripts; [mise](../mise/SKILL.md) owns tasks). ## Workflow 1. **Pick the native scheduler**: [Linux user timers](references/linux.md) or [macOS LaunchAgents](references/macos.md) (keep existing project schedulers unless migrating; host skills own harness-native schedules). 1. **Version definitions in the owning repo**: invoke an absolute executable path with locked dependencies and a single-writer lock; enable only after the user approves the schedule and recurring effects. 1. **Prove a real timer-triggered run** and its application outcome (manual runs or enabled units alone are partial proof). ## Owner conventions - **`fmind/dot` user units**: store in `dot_config/systemd/user/`, enable via `timers.target.wants` symlinks, and register unit hashes in `run_onchange_after_systemd-user-reload.sh.tmpl` (`systemctl --user daemon-reload` on apply). - **Never restart the `agy` daemon during apply**: it may host the active Remote Control session, so the reload hook only prints the restart command. ## Gotchas - **Stay in user space**: never use `sudo`, system units, or `loginctl enable-linger` unasked; note if requested availability exceeds logged-in sessions. - **Handle missed or timed-out runs explicitly**: choose skip vs coalesce deliberately and reconcile current state before re-running mutations. ## Documentation - [systemd timers](https://www.freedesktop.org/software/systemd/man/latest/systemd.timer.html) · [Apple scheduled jobs](https://developer.apple.com/library/archive/documentation/MacOSX/Conceptual/BPSystemStartup/Chapters/ScheduledJobs.html)
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.