Scheduled Initiatives

Scheduled initiatives (also called periodic initiatives) run automatically on a recurring basis. They use the same initiative mechanism as one-off initiatives but include a schedule configuration so Hefty runs them without being asked each time.

Schedule Syntax

The /do every command creates a scheduled initiative in the command bar. The schedule part specifies how often the initiative runs, and the goal part describes what Hefty should accomplish.

/do every hour Check server health — runs every hour /do every day at 09:00 Send morning report — runs daily at a specific time /do every week Generate git summary — runs once per week /do every month Review security logs — runs once per month /do every 2h Sync database backups — custom interval (every 2 hours) /do every 30m Check queue depth — custom interval (every 30 minutes)

Use the at qualifier to specify a time-of-day for the schedule — for example, at 09:00 or at 17:30. This works with daily and weekly frequencies.

Frequency Options

  • Hourly — runs once per hour
  • Daily — runs once per day, optionally at a specific time
  • Weekly — runs once per week, optionally on a specific day and time
  • Monthly — runs once per month
  • Custom interval — any frequency specified in minutes (e.g., every 15 minutes, every 6 hours)

Time and Day Selectors

When using the create dialog, scheduled initiatives offer a time-of-day selector to pick the exact time the initiative should run. A day-of-week selector is available for weekly schedules to choose which day the initiative runs. All times respect the configured timezone.

Timezone Configuration

All schedule times use the configured timezone, so "every morning at 9am" means 9am in your timezone — there is no need to convert between time zones manually.

Managing Scheduled Initiatives

  • Each scheduled initiative tracks its run count, success count, and failure count.
  • Active scheduled items show a "Next: X" countdown indicating when the next run will occur.
  • From the sidebar Templates tab, you can: trigger a manual run immediately (the ⚡ action), pause or resume the schedule, edit the initiative, or delete it.
  • Execution history is shown in the schedule section of the initiative details dialog.