armadillo-scheduler

OS-native task scheduling for any armadillo skill — natural language input, macOS launchd execution, allowlisted prompt security. Use when scheduling tasks, viewing schedules, or managing scheduled jobs.

Model	Source	Category
sonnet	core	Other

Full Reference

┏━ ⏰ armadillo-scheduler ━━━━━━━━━━━━━━━━━━━━━━━┓
┃ [one-line description of what scheduling action] ┃
┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

Schedules any armadillo skill or workflow via macOS launchd — natural language input converted to cron, registered as a plist, and executed headlessly by Claude Code. Supports one-time and recurring schedules with SHA-256 allowlisted prompt security.

Commands

Intent	Command
Schedule a task	`node scripts/scheduler/register.js`
Remove a schedule	`node scripts/scheduler/unregister.js`
List all schedules	`node scripts/scheduler/list.js`
Check task status	`node scripts/scheduler/status.js`
Run task now	`node scripts/scheduler/run-now.js`
View run history	`node scripts/scheduler/history.js`
View/rotate logs	`node scripts/scheduler/logs.js`

Registration Flow

Parse schedule — convert user’s natural language to cron via naturalLanguageToCron() from scripts/scheduler/cron.js
Fallback — if NL parsing fails, ask user for cron expression directly
Compose prompt — write the execution prompt Claude will run when the task fires
Confirm with user — show task name, schedule (humanized), prompt, and working directory before proceeding
Register — call registerTask() from scripts/scheduler/register.js
Report — output task ID, next run time, and log file location

Reference

Doc	Contents
`reference/commands.md`	Full command API and options
`reference/schedules-json-schema.md`	Data model for `schedules.json`
`reference/launchd-patterns.md`	Plist patterns and launchd config
`reference/security-model.md`	Prompt allowlist and SHA-256 verification
`reference/edge-cases.md`	Edge case handling

Constraints

Prompts are allowlisted at registration — SHA-256 hash verified before every headless execution
Max turns capped per task (default 20)
macOS only (launchd) — Linux/Windows not yet supported
Always confirm prompt with user before registering
Never modify an existing task’s prompt without re-confirmation