Skip to main content

Scheduling & Notifications

Three command groups for time-based automation: genie schedule manages triggers, genie daemon controls the scheduler process, and genie notify configures delivery channels.

Schedule Commands

genie schedule create

Create a new scheduled trigger.
Exactly one of --at, --every, or --after is required.

genie schedule list

List schedules with next due trigger time.

genie schedule cancel

Cancel a schedule and skip pending triggers.

genie schedule retry

Reset a failed trigger to pending so it runs again.

genie schedule history

Show past executions for a schedule.

Daemon Commands

The scheduler daemon is the background process that polls for due triggers and executes them.
genie daemon start now redirects to genie serve --headless. Use genie serve start directly for explicit control over service startup. See Infrastructure for serve options.

genie daemon start

Start the scheduler daemon.

genie daemon stop

Stop the scheduler daemon gracefully.

genie daemon status

Show daemon state, PID, uptime, and trigger stats.

genie daemon install

Generate a systemd service unit and enable it for auto-start on boot.

genie daemon logs

Tail structured JSON scheduler logs.

Notification Commands

Configure where Genie delivers notifications (task updates, schedule alerts, etc.).

genie notify set

Set a notification preference for a channel.

genie notify list

List notification preferences.

genie notify remove

Remove a notification preference.