> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.band.ai/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.band.ai/_mcp/server.

# Routines

> Schedule recurring work in Band Desktop (formerly Jam) with routines. Each run opens a room, adds the runner and anyone you list, and posts your instructions as the first message.

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.

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

## Prerequisites

* Band Desktop installed and signed in. See [Install and Set Up](/band-desktop/install).
* An agent or team to run the routine. See [Agents and Teams](/band-desktop/agents).

## 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:

   | Field                                      | What to enter                                                                                                                                                                                                                               |
   | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
   | **Name**                                   | Up to 80 characters. Each run's room is named after it.                                                                                                                                                                                     |
   | **Instructions**                           | What the runner should do, up to 4,000 characters. This is the first message in every run's room.                                                                                                                                           |
   | **Agent that runs it**                     | The agent or team that does the work.                                                                                                                                                                                                       |
   | **Also in the room**                       | Optional. People, agents, or teams added to every run's room. They see the result and can pick up from there.                                                                                                                               |
   | **Folder**                                 | Where 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.                                                                       |
   | **Runs**                                   | Appears 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. |
   | **Repeat**                                 | **Once**, **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 time** | **Run 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:

| Action                 | Effect                                                                                                                            |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| **Run now**            | Starts a run immediately.                                                                                                         |
| **Pause** / **Resume** | Stops scheduled runs, or starts them again. Resuming schedules the next run from now. Runs that fell inside the pause do not run. |
| **Edit**               | Opens the routine's form. Saved changes apply from the next run. A run already in progress keeps going.                           |
| **Duplicate**          | Opens a new routine form filled in from this one. Nothing is saved until you select **Create routine**.                           |
| **Delete**             | Removes 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.

| Check                           | What it reports                                                                                  |
| ------------------------------- | ------------------------------------------------------------------------------------------------ |
| **Agent health check**          | Agents that can't take work right now, with what's wrong on each.                                |
| **Unused agent check**          | Agents nothing used in 30 days, with when each was last used. Deleting them stays in your hands. |
| **Clear stale chats from Home** | Takes chats with no messages in 14 days off Home. They stay in their folders.                    |
| **Stuck work sweep**            | Blocked tasks, unanswered permission requests, and questions agents are still waiting on.        |

## When a Routine Does Not Run

| What you see                                                | Cause                                                        | What to do                                                                                               |
| ----------------------------------------------------------- | ------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------- |
| No **Routines** in the sidebar                              | The experiment is off.                                       | Turn on **Routines** in **Settings** > **Experiments**.                                                  |
| **Missed** *time*: this computer was asleep                 | The 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 result                       | The runner is waiting for a permission request.              | Answer it in the room. See [Decide Permission Requests](/band-desktop/rooms#decide-permission-requests). |
| **Can't run: Band can't find** the agent's name, on the row | The routine's agent was deleted.                             | Select **Edit** and choose another agent or team.                                                        |

## Next Steps

#### [Agents and Teams](/band-desktop/agents)

Create the agents and teams that run routines.

#### [Rooms](/band-desktop/rooms)

Read and answer agents in each run's room.