Work with agents
Scheduled tasks
Realm can start an agent in one of your spaces on a clock you set, once or on repeat, and keeps every run on the Scheduled page to read and carry on.
Schedule a task
- Press Scheduled tasks on the rail, then New task.
- Give it a Task name and write its instructions. Write them for an agent that has never seen your conversation, because that's what a scheduled run is.
- Leave Repeat task on and choose how often, or turn it off to run it once at a date and time.
- Under Advanced, choose the Space it runs in and its Model, and whether each run starts a new session.
- Press Create.
| Repeat | Runs |
|---|---|
| Hourly | Every hour, at the minute you pick |
| Daily | Every day at a time |
| Weekdays | Monday to Friday at a time |
| Weekly | On one day a week at a time |
| Monthly | On one day of the month at a time |
| Custom (cron) | A five-field cron expression in your local time: minute, hour, day of month, month, weekday |
0 9 * * 1-5Suggested under the list offers three tasks worth having on a clock, ready to adjust: Weekly review, Morning brief and Watch CI.
An agent can schedule one for you, too. Ask in a session, "every Friday at 4, write up the week", and its agent uses Realm's scheduling tool to create the task in that space. It reads the space's existing schedules first, so it doesn't make one you already have.
Runs
- Each run is a session, and lands under its task on the Scheduled page rather than opening a pane beside whatever you're doing. A run you haven't read is marked unread until you open it.
- Runs work in Full access, since nobody is there to answer a permission card. If a run stops and asks for a person anyway, Realm tells you, as it does when a run finishes (Settings ▸ Notifications).
- By default each run starts a new session. Turn off Start each run in a new session and each run continues the last one's conversation instead.
- Archive successful runs keeps finished runs out of the sidebar. Failed and interrupted runs stay visible.
Selecting a task shows its card: when it runs, its instructions, its outputs, the next run and its model, and the space's connections it can use under Sources. The card's ⋯ has Run now, Pause or Resume, and Delete task…; the pencil edits it. A one-time task that has already run has nothing left to pause, but the pencil can still rename it or change its instructions, and a new time runs it again.
When your Mac is asleep or Realm is closed
Closing Realm's window, or ⌘Q, leaves Realm running in the menu bar, and schedules keep firing. Only Quit Realm & stop agents in the menu bar stops them.
| If a run was due while… | Then |
|---|---|
| the Mac slept, and it wakes within 6 hours | The run starts once, when Realm comes back |
| the Mac slept for longer than that | That run is skipped, and the task says so. A week of runs never all start at once. |
| it's a one-time task | It runs as soon as it can, however late |
Times are your Mac's local time, through daylight saving changes too. On the day the clocks go forward, a time in the skipped hour runs at the first minute after it, so a daily task at 2:30 runs at 3:00 (an hourly task skips that hour). On the day they go back, a time in the hour that repeats runs once.