Bigger Tasks & Schedules

Initiatives are autonomous multi-step goals where Hefty plans and executes a dynamically constructed graph of activities on its own. In a regular conversation you send one message and Hefty responds in a single request-response cycle. An initiative works differently: you set a goal, Hefty builds a multi-step plan, and then works through each step autonomously — generating multiple activities without further input from you. Initiatives can be one-off (run once to completion) or scheduled (run on a recurring basis), and you retain control throughout — you can pause, cancel, or steer an initiative at any time.

When to Use Initiatives

Use an initiative when you want Hefty to tackle something larger than a single message. Some examples:

  • "Set up CI/CD for this project" - Hefty plans the steps (create config files, set up test runner, configure deployment), then works through them one by one
  • "Refactor the authentication module to use JWT" - Hefty breaks it into steps (audit current code, update dependencies, rewrite auth logic, update tests) and tracks progress
  • "Check the server health every morning at 9am" - a recurring initiative that runs automatically on schedule
  • "Generate a weekly summary of git activity every Friday" - a periodic task Hefty handles without you having to ask each time

Explore This Section