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

New Task and suggestions

The task editor
Triggers
| Trigger | Runs |
|---|---|
| Run once | At one time, then the task archives itself. |
| Schedule | Repeatedly, on a cron schedule, between optional start and end dates. |
| Event | When a matching email, calendar, reminder, location, health, home, music, photo, message or note event happens. |
| None | Only 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
| Task | What it does |
|---|---|
| Insights | Turns new timeline events into insights and todos, and resolves them as they’re handled. |
| Writing Style | Learns your writing style from each account’s sent mail, for drafting replies. |