Schedules
Keep daily, hourly, weekly, yearly, and one-shot skills in tidy frequency buckets.
THE TINY WORKER WITH A BIG CLOCK
Let your skills run on time. Probably.
A cheerful, safety-minded cron worker for Muse AI skills, shell scripts, retries, locks, and the occasional sleepy cat.
✦⌁●Trusted by tiny automations everywhere
✦
✦
SAFE RETRIES✦LOCKS THAT WORK✦AGENT + SCRIPT✦ONE-SHOT SKILLS✦SAFE RETRIES✦LOCKS THAT WORK✦AGENT + SCRIPT✦ONE-SHOT SKILLS
WHAT IS MUSE-CRON?
The friendly control room for your scheduled AI work.
muse-cron turns a tidy directory of skill definitions into dependable, inspectable jobs. Put a skill in a frequency bucket, describe what it should do, and let the worker handle scheduling, locks, timeouts, retries, logs, and state.
It is intentionally small and transparent: standard-library Python, Markdown prompts, shell-script support, and an agent adapter that can connect to your Muse runtime through MUSE_AGENT_COMMAND.
↗
No pile-ups
Per-skill locks stop jobs from tripping over each other in the hallway.
Agent or script
Use an agent prompt, a shell script, or both. The worker does not judge.
HOW IT WORKS
From skill file to calm little log line.
01
Define
Write frontmatter and a clear prompt or companion script.
02
Validate
Catch malformed skills before they land in the 3 a.m. queue.
03
Execute
Run with a lock, timeout, retries, output capture, and state.
04
Review
Read per-skill logs and the last-run status at a glance.
BUCKETS AT A GLANCE
There is a place for every cadence.
Use the explicit schedule in a skill when you need a custom expression. Run-once jobs use an ISO-8601 run_at timestamp and can archive themselves after success.
minutely* * * * *
hourly5 * * * *
daily0 3 * * *
weekly0 4 * * 1
monthly0 5 1 * *
runoncerun_at → archive
Overlap prevention, but make it polite.
Agents and scripts can be friends.
COME HANG OUT
Ask questions. Share skills. Bring snacks.
Join the Muse AI community and swap ideas with other people who think a cron worker deserves a personality.
◖muse-cron community lounge
LIVE COMMUNITY✦ ✦ ✦
THREE COMMANDS TO HAPPINESS
Validate. List. Run.
Run these from the project root.
./bin/muse-cron validate
./bin/muse-cron list
./bin/muse-cron run --due