Automation

Tasks

A task is a job the agent runs for you: once at a set time, on a repeating schedule, or when something happens. Open Tasks from the bolt icon on Home. To create your first one, follow Set up a recurring task.

Tasks list with Sync X Bookmarks, The Tanmay Daily and Current Weather

Tasks

New Task screen with suggested tasks

New Task and suggestions

Task editor first page with name, description and Enabled switch

The task editor

Triggers

TriggerRuns
Run onceAt one time, then the task archives itself.
ScheduleRepeatedly, on a cron schedule, between optional start and end dates.
EventWhen a matching email, calendar, reminder, location, health, home, music, photo, message or note event happens.
NoneOnly when you tap Run, or ask for it in chat or with Siri.

Results

  • Text or JSON results, in the format you describe.
  • Notify me on completion sends the result as a notification.
  • Show a widget draws the result as a widget. See Widgets.
  • Tasks can also write files, like a newspaper-style HTML page, into their own folder.

Running and history

Tap Run to run a task now. Touch and hold a task for Run Now, Stop, Edit, Archive and Delete. Open it to see the result, statistics, recent runs, each agent session and the raw log, or tap Report Issue. A Live Activity shows progress while it runs.

You can run a task from Siri, Shortcuts or the Action Button with the Run Task action (“Run Current Weather in Halo”).

Limits

  • A run can last up to 15 minutes.
  • After 5 failures in a row, a task is paused until you turn it back on.
  • Event triggers group events that arrive within about 20 seconds into one run.
  • Scheduled tasks run on your primary device, and on a client if the primary misses one by 3 minutes.
  • Halo has to be able to run in the background. If iOS closes the app mid-run, a one-time task may not run again.

No permission prompts

Tasks run without asking before each tool. Give a task only the tools, MCP servers and skills it needs, and keep Require Face ID on for Secure Vault items it might use.

Built-in tasks

TaskWhat it does
InsightsTurns new timeline events into insights and todos, and resolves them as they’re handled.
Writing StyleLearns your writing style from each account’s sent mail, for drafting replies.