Docs / For owners and guests
Run background work as tasks
Hand longer work to your assistant as a task and keep chatting while it runs.
Checked against the product on 8 Nov 2026
What this page states, and how each is checked
- Typing /subagents and some words at the start of a message makes a background task, for owners and for guests, in any letter case (for example /BG).Automated test
- /subagent, /background and /bg are other names for /subagents.Setting in the code
- Owners can add a task by hand with the Add task button.On-screen text
- A command only counts at the very start of a message; "hello /subagents" or a path like /about/page is sent as a normal message.Automated test
- /subagents with nothing after it is not run; the box asks what should run.Automated test
- Typing / opens a menu of commands; owners see /subagents and /interview, guests see only /subagents.Automated test
- The first line becomes the task's title and the rest becomes its details.Automated test
- The words after a command are cut to 2,000 characters.Setting in the code
- An owner's task goes straight to the assistant with no okay, and the guest does not see it unless the owner shows it. The assistant is woken with "A task is ready to run", told to use background helpers, reports how many helpers it uses, and the chat gets a line such as "Background task 1 is done: Plan the launch" when it finishes.Automated test
- A guest's task waits for the owner's okay, the assistant is not told about it and cannot start it until then, and after the okay it goes to the assistant. The guest sees the tasks they add.Automated test
- On Full handoff a guest's task skips the okay and goes straight to the assistant.Automated test
- The owner can decline a guest's task with an optional note. A guest can stop a task they added before it starts, but not a task the owner added.Automated test
- A guest who tries to stop a running task is told "It has started already. Ask in the chat if it should stop."Setting in the code
- A guest can have at most 3 open tasks in one conversation; one more is refused.Automated test
- Open means waiting for the okay, waiting to start, or running.Setting in the code
- One conversation can hold at most 50 open tasks from anyone.Setting in the code
- The owner can stop a running task; the assistant is told to stop any helpers on it, and a stopped task takes no result.Automated test
- The owner can change a task's words only before it starts, and can show a task to the guest later.Automated test
- Once a conversation has ended, no task can be added or started in it.Automated test
- The Tasks page groups tasks as Needs your okay, Running, Waiting to start and Finished.Setting in the code
- The assistant can add its own background work, which the guest does not see by default.Automated test
- Tasks are listed across all the conversations in a workspace.Automated test
- A task has a Stop button.On-screen text
- Stopping a task is confirmed with Stop it.On-screen text
Automated test: a test in the product must pass. On-screen text: the words must exist in the product. Setting in the code: the number is read from the code. The docs are published only when every check passes.
Tested with Claude only
Type /subagents and a few words in a chat to hand that work to your assistant as a background task, then keep talking. Your assistant does the work and decides how many helpers to use; Two Cans holds the task, shows where it is, and keeps the result.
Start a task
- In the reply box, type
/subagentsand what should run, for example/subagents research three venues. - Send it. The first line becomes the task's title; anything below it becomes the details.
/subagent, /background and /bg do the same, in any letter case. The command only counts at the very start of a message, and with nothing after it the box asks what should run. Typing / opens a menu with Run in the background.
Owners can also type a task into the Tasks section of a conversation and press Add task.
Who can add tasks
- You, the owner: your task goes straight to the assistant. The guest does not see it unless you choose to show it.
- A guest: their task shows as Needs your okay. The assistant is not told about it until you press Okay. Press Decline to turn it down, with a note if you like. On Full handoff a guest's task inside the project skips the okay.
- The assistant: it can add its own background work.
Limits
- A guest can have 3 open tasks in one conversation at once. Open means waiting for an okay, waiting to start, or running.
- One conversation holds at most 50 open tasks from anyone.
- The words after a command are cut to 2,000 characters.
- Once a conversation has ended, no task can be added or started in it.
Follow your tasks
The Tasks page lists tasks from all your conversations in four groups: Needs your okay, Running, Waiting to start and Finished. When a task finishes, the chat gets a line such as "Background task 1 is done: Plan the launch". A guest sees the tasks they add, and any you choose to show them.
You can change a task's words only before it starts.
Stop a task
- Press Stop on the task.
- Press Stop it to confirm.
You can stop a task even while it runs. If it was running, the assistant is told to stop its helpers, and a stopped task takes no result. A guest can stop only a task they added, and only before it starts; after that they are asked to raise it in the chat.
Interviews are a kind of task too: see Ask someone a set of questions.
Trust levels are set per conversation: see Decide what your assistant may do alone.