argszero/cordis-plugin-schedule-cron
Cron rules that spawn a fresh agent run per fire, so scheduled work happens with no session open, unlike the official scheduler.
Fills a gap the official scheduler documents for itself: @deepseek-ai/dsh-schedule delivers a follow-up into the live session and offers fixed intervals, with no calendar rules, so a closed session leaves the reminder overdue and "every weekday at 9" cannot be expressed. This plugin parses standard 5-field cron and, when a rule is due, composes a fresh agent session and drives its first turn with the rule's task text — the same primitive the ACP bridge uses for non-interactive sessions. The engine is exported as a dependency-free collectDue over cursors, so the scheduling logic can be driven by any timer and is unit-tested without a harness.
Install
dsh plugin add @argszero/cordis-plugin-schedule-cronThe bundle-patch line, and the README is explicit that installing the npm package alone leaves it unmounted — dsh plugin add is what registers the profile bundle. Rules then live in the profile's Cordis overlay as a schedule-cron entry with a cron list, each carrying id, expression and task plus optional provider, model, cwd and enabled, with tickMs defaulting to 60000.
Compatibility
Fire semantics are the part to understand before scheduling anything expensive: each rule keeps a monotonic cursor, every occurrence fires exactly once, and on first mount every cursor anchors to its next future occurrence so there is no backfill burst for times that already passed. A long-downtime window is capped at four catch-up fires per tick. initialState restores lastFiredAt per rule id, so a restart mid-window resumes forward instead of re-firing. The package declares every dsh package it reads as a peer with one shared range, stated in its own section.
Details
- Repo: argszero/cordis-plugin-schedule-cron
- Category: Workflow & Automation
- Stars: 0
- Version: 0.1.2 (npm)
- Last push: 2026-10-25
- First seen: 2026-09-04
Alternatives
Ceelog/dsh-plugins#dsh-plugin-scheduled-tasks · Zhiyi-Zhao/dsh-schedule-send · rpglit/dsh-schedule-later-hardened