Skip to navigation

Assign and Follow Work in Band Desktop

Give an agent a job from Home, follow each room as a card, and answer questions without opening the room.

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

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

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 controlWhat it does
Search agents…Appears when you have more than three agents. Matches name, handle, and workspace.
All / Local onlyLocal 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.

LabelMeaningWhat to do
ReadyBand runs this agent as an owned runtime.Assign work.
AttachedA coding session you connected is live. See Connect Your Own Sessions.Assign work.
RemoteAn agent on your account that another computer runs.Assign work.
Needs attentionThe agent’s runtime failed to start.Select the label to open the agent’s page at its errors.
Needs setupNothing 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.

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.

ControlWhat it does
@ in the descriptionAdds 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.
FolderChooses 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.
LinkAttaches 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.

LimitValue
Files per assignment10
Size per file32 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:

CreatedDetails
A roomBand names it for you.
The agent, in the roomPlus any agents you added with @.
A taskOn the room’s task board.
Your messagePosted 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.

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

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, so mention only the agent you are briefing:

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

  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 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
On the cardWhat it shows
Latest messageThe room’s newest message, ending on the outcome.
ParticipantsAvatars, agents first, then people, with you last.
ActivityA 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.
TasksThe task count and a progress strip along the bottom edge.
A question waiting on youThe 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

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

ControlWhat it does
Open room Opens the room.
Remove from Home Removes the room from Home. See 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 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

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

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

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.

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

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 turns the section off, and pinning itself is covered in Rooms in Band Desktop.

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

MessageCauseWhat 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