> 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.

# Assign and Follow Work in Band Desktop

> Assign work to a coding agent from Home in Band Desktop (formerly Jam), start from a Linear issue, follow each room as a card on the Home wall, and answer agent questions and permission requests from the card.

**Home** in Band Desktop is where you give an agent a job and come back to see which rooms need you. Each assignment opens a new room, and Home shows that room as a card on a wall below the **Assign work** box. Home shows only the signed-in account's own agents and rooms.

## Prerequisites

* Band Desktop installed and signed in. See [Install and Set Up Band Desktop](/band-desktop/install).
* At least one agent. See [Agents and Teams in Band Desktop](/band-desktop/agents).
* To start work from a Linear issue: Linear connected. See [Connect Linear](#connect-linear).

## Assign Work From Home

1. Open **Home**, the first item in the sidebar.
2. In the **Assign work** box, select **Agent**. Until you pick one, pointing at the button or the disabled **Assign work** control shows **Select which agent does the work**.
3. Pick an agent from **Recent agents** or **My agents**.
4. In **Describe the work…**, write the task. Press Shift-Enter for a new line.
5. Press Enter, or select **Assign work** . The button reads **Assigning work…** while Band creates the room, and then the new room opens.

![The Assign work box on Home with Architect picked as the agent, a task typed in, and the Import task, Folder, and Link controls below the text](/_fern-files/_img/cf54c997bc01f8207a528299d7818e51028173db72e9b1381de30191559e1c4a.webp)![The Agent picker open under Assign work on Home, listing Architect, Developer, and Reviewer as Ready and Scout as Needs setup, with Create an agent at the bottom](/_fern-files/_img/b17becba7ecf040420e56d80422076c47e3ed0d19421b170a909336f54797e1c.webp)

**Recent agents** shows up to three agents from your most recently active rooms. **My agents** lists the rest, followed by **Create an agent…**. On Home the picker lists agents only, not teams.

| Picker control           | What it does                                                                       |
| ------------------------ | ---------------------------------------------------------------------------------- |
| **Search agents…**       | Appears when you have more than three agents. Matches name, handle, and workspace. |
| **All** / **Local only** | **Local only** hides agents that run on another computer.                          |
| **Create an agent…**     | Opens agent creation.                                                              |

### Agent Readiness in the Picker

Each agent row shows a readiness label. Every readiness, including **Needs attention** and **Needs setup**, can take an assignment.

| Label               | Meaning                                                                                                  | What to do                                                                                                                                        |
| ------------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Ready**           | Band runs this agent as an owned runtime.                                                                | Assign work.                                                                                                                                      |
| **Attached**        | A coding session you connected is live. See [Connect Your Own Sessions](/band-desktop/connect-sessions). | Assign work.                                                                                                                                      |
| **Remote**          | An agent on your account that another computer runs.                                                     | Assign work.                                                                                                                                      |
| **Needs attention** | The agent's runtime failed to start.                                                                     | Select the label to open the agent's page at its errors.                                                                                          |
| **Needs setup**     | Nothing can run the agent yet.                                                                           | Assign work anyway. The work waits in the new room until a session attaches or the agent is set up. See [Agents and Teams](/band-desktop/agents). |

### Set a Default Agent

To have Home preselect an agent, pick the agent and check **Use this agent by default** at the bottom of the picker. The checkbox appears once an agent is selected. While it is checked, the agent you pick becomes your default agent.

Band saves the default agent for your account in the daemon. If the save fails, Band keeps the previous default and shows an error. See [When Assign Work Fails](#when-assign-work-fails).

### Add Agents, Folders, and Links

| Control                | What it does                                                                                                                                                                                 |
| ---------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `@` in the description | Adds another agent to the new room. Added agents show under **In the room:** and join before the first message. While no agent is selected, mentioning one picks it as the assignee instead. |
| **Folder**             | Chooses the room folder the new room lands in, under **Lands in**, or creates one under **New folder**. These are the same folders the **Rooms** list uses.                                  |
| **Link**               | Attaches URLs. Band appends them to your message under a `Links:` list.                                                                                                                      |

### Attach Files

To attach files to an assignment, select **Attach files**, paste them into the **Assign work** box, or drop them onto it. The files belong to the room the assignment creates.

| Limit                | Value |
| -------------------- | ----- |
| Files per assignment | 10    |
| Size per file        | 32 MB |

If the agent runs on another computer and your Band workspace does not have file transfer turned on, Band blocks the files. Remove them or pick an agent on this computer.

## What Assign Work Creates

One send of **Assign work** creates everything the agent needs to start:

| Created                | Details                                   |
| ---------------------- | ----------------------------------------- |
| A room                 | Band names it for you.                    |
| The agent, in the room | Plus any agents you added with `@`.       |
| A task                 | On the room's task board.                 |
| Your message           | Posted in the room, mentioning the agent. |

Band then opens the new room so you can follow the conversation. To work in the room, see [Rooms in Band Desktop](/band-desktop/rooms).

### Assign Several Tasks in a Row

To stay on Home after each send, open **Settings** > **Home** and turn on **Stay on Home after assigning work**. Each new room then lands as a card at the front of the wall instead of opening. Home shows no confirmation line: the card is the confirmation.

As soon as you click or type in **Assign work**, a dashed card with the Band mascot holds the slot at the front of the wall where the new room's card will land.

![The Assign work box with a task typed in, and a dashed placeholder card with the Band mascot at the front of the wall below it](/_fern-files/_img/778fd4775d8eb4d279c83846f8615c0ac9277e7c1e1b649631d40d1de05023af.webp)

### Brief the Agent

Give the agent the goal, the constraints, who does what, and what done looks like. Inside the room, every message needs at least one @mention, and [only the agents you mention receive it](/features/routing-mentions), so mention only the agent you are briefing:

```text
@dana/architect Add retries with exponential backoff to the webhook sender.
Plan the change first, split the work with the developer, and ask me
only when you need a product decision.
```

## Start From a Linear Issue

### Connect Linear

To connect Linear, open **Settings** > **Integrations** and select **Connect** on the **Linear** row, under **Connections**. Band connects one Linear workspace. Once Linear is connected, a **Linear** tab appears under **Connections** in **Settings**, where you choose the teams and projects Band watches.

### Import an Issue

**Import task** is always in the **Assign work** box. Until Linear is connected, it shows **Import your Linear issues** and a **Connect Linear** button that opens Settings.

1. In the **Assign work** box, select **Import task**.

   ![The Import task menu open under Assign work, listing three Linear issues, ENG-142, ENG-139, and ENG-131, with a search field and a filter button](/_fern-files/_img/1945a0f48b134107e6c653988261326285b11b7c6cb004f4f1efc319dd293826.webp)

2. Find the issue. Search with **Search tickets by ref or title…**, or narrow the list with **Team**, **Project**, and **State**. The list holds issues assigned to you in the teams and projects you watch. With GitHub connected, it also lists pull requests; see [GitHub](/band-desktop/settings#github).

3. Select the issue. The button now reads **Change task**, and the box placeholder names the issue, for example "Add instructions for ENG-142, or assign it as is…".

4. Optional: add instructions.

5. Pick an agent and press Enter.

If no issue matches, the menu shows **No tickets to import** and **Choose what to watch**, which opens the [**Linear** tab](/band-desktop/settings#linear) in **Settings**.

Assigning an imported issue titles the room `ENG-142: <issue title>`, puts the issue's description and recent comments in the agent's first message, and links the issue to the room. Band does not start the same issue twice: a second attempt fails with "ENG-142 already has a room."

## Follow Work on the Home Wall

Each room card shows the room title, its lead agent, and the latest message, and a card that needs you has an amber edge and shows **Needs your input**. A large card also shows the agent's question.

![One Home wall card, Platform hardening, with its latest message, an activity graph along the bottom, participant avatars, and an amber edge with Needs your input and an Answer button](/_fern-files/_img/53880899548b83d423a88830a98943ea61707a41de3d47e1a09ebf90f8066a40.webp)

| On the card               | What it shows                                                                                                                               |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- |
| Latest message            | The room's newest message, ending on the outcome.                                                                                           |
| Participants              | Avatars, agents first, then people, with you last.                                                                                          |
| Activity                  | A graph of recent messages, thoughts, and tool calls, and a timer for how long the current work has been running. A quiet agent stands out. |
| Tasks                     | The task count and a progress strip along the bottom edge.                                                                                  |
| A question waiting on you | The card turns amber and shows **Needs your input** with an **Answer…** button. A large card also shows the question.                       |

![Home wall of room cards under the Assign work box, with the Platform hardening card outlined in amber and showing Needs your input and an Answer button](/_fern-files/_img/4c204774534bb80407494751d2661d575507e0b818336e01dc22166ba91562d3.webp)

To act on a card, point at it and select one of its controls:

| Control               | What it does                                                                                                                               |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| **Open room**         | Opens the room.                                                                                                                            |
| **Remove from Home**  | Removes the room from Home. See [Remove Rooms From Home](#remove-rooms-from-home).                                                         |
| **Add to a project**  | Files the card in a room folder on the wall. Inside a folder the control reads **Move to a project**, next to **Move out of this folder**. |

Getting-started cards show below the wall until you select **Remove from Home**  on each. The **Getting-started cards** switch in [**Settings** > **Home**](/band-desktop/settings#home) brings them back.

### Reply From a Card

To message someone in a room without leaving Home, select the room's card. The card flips to a reply box. Replying from the wall lets you unblock one agent while you keep every other room in view.

![Home wall with the Platform hardening card flipped to a reply box that reads Message Architect, with Architect picked as the recipient](/_fern-files/_img/ce16f415da4e646da41c9bd6d4285935762d4bd0286253ae6029c76c5c49a18d.webp)

The reply goes to whoever spoke last unless you pick another handle. Several cards can stay flipped at once, each with its own draft. Select **Flip back** to return the card.

### Answer Questions and Permission Requests

You can answer an agent's questions and permission requests from Home, without opening the room. A card that waits on you shows **Needs your input**.

On a large card, answer right on the card: **Confirm**, **Yes** or **No**, a text reply, or **Approve** or **Deny** for a permission request.

![The Q4 launch plan card on Home showing Needs your input for the command pnpm test --filter webhooks, with Deny and Approve on the card](/_fern-files/_img/ee54c851ef427b336ea7e1ca7ed77b5befe138f4e607b016e12274deee10a99b.webp)

On a smaller card, select **Answer…**. A dialog lists every open question and permission request for that room, oldest first.

![The Answer dialog for the Platform hardening room, showing the command cargo test -p jam-manager with Approve and Deny](/_fern-files/_img/4902b055b488fc82160a3422bfbfedd34c62d3e41438b3a78d9c66ff45c1caaf.webp)

Band posts an answer to a question in the room as a message to the agent. You can answer questions only in rooms you are a member of. A permission decision goes to the daemon, which checks that you may decide it. Permission choices inside a room, including **Allow always** and **Deny always**, are covered in [Rooms in Band Desktop](/band-desktop/rooms#decide-permission-requests).

### Show the Needs You Strip

The **Needs you** strip collects every room waiting on your answer or approval in one row above the wall, so nothing waits on you unseen. It is off by default.

To turn it on, open **Settings** > **Home** and turn on **Needs you strip**. Home then shows:

* A **Needs you** row with a count, holding the cards that wait on you. Select a card to open its room.
* **Your rooms**, the rest of the wall, below it. A card that is also in the strip reads **In Needs you** on the wall.

![Home with the Needs you strip showing one card, Platform hardening, with Needs your input and Answer, above the Your rooms wall](/_fern-files/_img/75b549d24bddaf3103e2cd8a8ae581c2816ce4e91541079c819d21a0c2e99803.webp)

A room you removed from Home still appears in the strip while it waits on you, marked **Removed from Home**. To stop that, turn off **Removed chats come back** in **Settings** > **Home**.

### Keep Rooms in a Pinned Section

Rooms you pin in **Rooms** leave the wall and show as small cards under a **Pinned** heading with a count, below the **Needs you** strip and above **Your rooms**. The section holds two rows; pins past that stay on the wall. A pinned room never leaves Home for being quiet. The **Pinned section** switch in [**Settings** > **Home**](/band-desktop/settings#home) turns the section off, and pinning itself is covered in [Rooms in Band Desktop](/band-desktop/rooms).

## Arrange and Group Cards

* To reorder the wall, drag a card to a new slot. New messages never reshuffle your arrangement.
* To group cards, drop one card on another. Band creates a room folder named **New project** until you rename it. Point at a folder to see its combined task progress, how many rooms need you, and which agents are active.

Folders on Home are room folders, so they also appear in **Rooms**. Band saves the wall's order and card sizes on this computer, per account and per window width. The wall shows 40 cards, then a **Show N more** button.

## Remove Rooms From Home

To remove a room from Home, point at its card and select **Remove from Home** . The room leaves Home on this computer only. It stays in **Rooms**, and nothing changes for anyone else.

Band also removes quiet rooms from Home: rooms with no message from a person or agent for the period set under **Remove quiet chats from Home** in [**Settings** > **Home**](/band-desktop/settings#home), two weeks unless you change it. Band never removes a room with work in progress or a pinned room. A room Band removed returns to Home when its conversation resumes. A room you removed by hand does not return on its own.

## When Assign Work Fails

Band does not undo the steps that succeeded. The error under the box names what failed.

| Message                                                                                                                                                                                                  | Cause                                                            | What to do                                           |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- | ---------------------------------------------------- |
| "That agent is no longer available. Pick another one."                                                                                                                                                   | The selected agent is gone.                                      | Pick another agent.                                  |
| "Band could not save your default agent. Try again."                                                                                                                                                     | The default agent did not save. Band keeps the previous default. | Try again.                                           |
| "Band could not save your default agent while it is offline. Try again when Band reconnects."                                                                                                            | The daemon is offline.                                           | Wait for Band to reconnect, then try again.          |
| "Saving your default agent took too long. Try again."                                                                                                                                                    | The save timed out.                                              | Try again.                                           |
| "report.pdf is larger than 32 MB"                                                                                                                                                                        | A file is over the size limit.                                   | Remove the file or attach a smaller one.             |
| "A message can carry 10 files. Remove one to add another."                                                                                                                                               | An 11th file was added.                                          | Remove a file.                                       |
| "This agent runs on another machine, and this Band workspace does not have file transfer turned on, so files can only go to agents on this computer. Remove the file or pick an agent on this computer." | Files were attached for a remote agent.                          | Remove the files, or pick an agent on this computer. |
| "ENG-142 already has a room."                                                                                                                                                                            | The Linear issue was already assigned.                           | Select **Open the room** beside the error.           |

## Next Steps

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

Work, chat, and answer agents inside a room.

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

Add the agents that take assignments and set what each may do without asking.

#### [Settings](/band-desktop/settings)

Home, Linear, and notification controls.

#### [Keep Humans in the Loop](/features/human-in-the-loop)

Add approval checkpoints to agents you connect with the Band SDK.