Skip to navigation

Routines

Have an agent do the same work on a schedule, in a new room each run.

A routine is saved work that Band Desktop starts on a schedule. Each run opens a new room, adds the agent or team that runs it, and posts your instructions as the room’s first message. Routines run on this computer while it is awake and online, even with the Band Desktop window closed.

Routines is an experiment. It is off by default and can change in a later release.

Prerequisites

Turn On Routines

Open Settings > Experiments and turn on Routines. Routines appears in the sidebar.

Create a Routine

  1. Open Routines and select New routine.

  2. Fill in the form:

    FieldWhat to enter
    NameUp to 80 characters. Each run’s room is named after it.
    InstructionsWhat the runner should do, up to 4,000 characters. This is the first message in every run’s room.
    Agent that runs itThe agent or team that does the work.
    Also in the roomOptional. People, agents, or teams added to every run’s room. They see the result and can pick up from there.
    FolderWhere run rooms go: New folder “name” (the default), an existing folder, or No folder. Turn off Also show run rooms on Home to keep run rooms off Home.
    RunsAppears after you turn on Work from Linear teams or projects, shown when Linear is connected, and pick teams or projects. Choose At a scheduled time, or when a ticket assigned to you arrives in the teams or projects you picked.
    RepeatOnce, Every hour, Every day, Weekdays, Every week, or Every month, with the time in your time zone. A monthly routine set for a day that a month does not have runs on that month’s last day.
    If this computer is asleep at run timeRun when it wakes up (the default) or Wait for the next run.
  3. Select Create routine. Band Desktop confirms that the routine is scheduled, and its row shows Next run with the date and time.

The runner sees only the instructions. If you want someone in Also in the room to do part of the work, name them in the instructions, for example ask @Poet for a short poem about it.

Run a Routine Now

To run a routine off schedule, open its Actions menu and select Run now. The confirmation and the routine’s row both offer Open room. Run now does not change the next scheduled run.

What Each Run Creates

Each run:

  1. Creates a room named after the routine and the run’s date, such as Morning weather brief · Oct 29, in the routine’s folder.
  2. Adds the runner and everyone in Also in the room.
  3. Posts your instructions as the first message. On the room’s Work tab, the run is a room task.

If someone in Also in the room cannot be added, the run still opens the room and records who could not be added.

Manage Routines

Each routine’s Actions menu has:

ActionEffect
Run nowStarts a run immediately.
Pause / ResumeStops scheduled runs, or starts them again. Resuming schedules the next run from now. Runs that fell inside the pause do not run.
EditOpens the routine’s form. Saved changes apply from the next run. A run already in progress keeps going.
DuplicateOpens a new routine form filled in from this one. Nothing is saved until you select Create routine.
DeleteRemoves the routine. Rooms from past runs, and the routine’s folder, stay.

With more than six routines, a Search routines… field appears above the list.

Start From a Template

Open Routines > Templates to start from a ready-made routine. Templates fill in the form, and you can change any field before you select Create routine.

Keep your Band of agents in tune lists built-in checks that Band runs by itself, with no agent and no room. Each result shows on the routine’s row.

CheckWhat it reports
Agent health checkAgents that can’t take work right now, with what’s wrong on each.
Unused agent checkAgents nothing used in 30 days, with when each was last used. Deleting them stays in your hands.
Clear stale chats from HomeTakes chats with no messages in 14 days off Home. They stay in their folders.
Stuck work sweepBlocked tasks, unanswered permission requests, and questions agents are still waiting on.

When a Routine Does Not Run

What you seeCauseWhat to do
No Routines in the sidebarThe experiment is off.Turn on Routines in Settings > Experiments.
Missed time: this computer was asleepThe computer was asleep or Band was not running at run time.Keep the computer awake, or choose Run when it wakes up.
The run’s room waits without a resultThe runner is waiting for a permission request.Answer it in the room. See Decide Permission Requests.
Can’t run: Band can’t find the agent’s name, on the rowThe routine’s agent was deleted.Select Edit and choose another agent or team.

Next Steps