Task delegation

An agent in a Room answers one message at a time. A long job, such as researching rivals or drafting a deck, would hold the chat until it finished, and your next question would wait behind it. A Task moves that job into the background. The agent in your chat, its Meta, hands the job to a background copy of itself, an AlterEgo, and stays free to talk. Each Task has its own AlterEgo, so several jobs can run at once. This works like a lead who hands a job to an assistant and stays in the meeting. The comparison stops at one point: an AlterEgo is a copy of the same agent, not a different agent. This page shows what you see while Tasks run, how the Meta and its AlterEgos work together, how the agent keeps you posted on long work, and how a new request reaches a running Task.

​

What do you see while a Task runs?

The agent keeps talking, a line above the message box counts its running Tasks, and each result arrives as a card.

• A short reply. The agent says in a line that the work is under way, then answers your next message as usual.
• The background line. Above the message box, a line reads “2 tasks running in the background”. Open it to see each Task’s name and how long it has run. The line disappears when no Task is running.
• A progress update. When a Task runs long and the agent goes quiet, the agent posts a short update on its own. See how the agent keeps you posted.
• Approval cards. A Task that needs your approval, for example before it sends mail, posts a card and waits. The card appears in the Room, or in your direct chat with the agent when you are not in that Room. A card that nobody answers expires after 10 minutes. See Approvals and permission review.
• The result. When a Task finishes, the agent posts a card with a short summary and the files. When a Task fails or needs your decision, the agent tells you in a message instead.

You manage a Task by talking to the agent: add to it, ask how it is going, or ask it to stop. Each agent runs up to 10 Tasks at once across all its Rooms, and a Task that waits for your approval does not count.

​

How do the Meta and the AlterEgo work together?

The Meta owns the conversation, and each AlterEgo owns one job. They hand work to each other through the server, never through your chat.

1. Start. The Meta runs teamhub task create with a name and a brief. The AlterEgo starts in its own session and workspace on the same computer. It never sees the chat, so the brief must carry everything it needs.
2. Work. The AlterEgo works in the background. It cannot post in the Room or ask you anything, because Linger blocks those commands inside a Task. A question goes into its report instead.
3. Report. When a turn ends, its last reply goes privately to the Meta as a report. No one else sees it. When the turn fails, the Meta gets the error.
4. Deliver. The Meta reads the Task’s files and decides what the Room needs: a card with the result, a question for you, or nothing.

The two workspaces share exactly one folder. The AlterEgo writes its outputs into playground/<task-id>/, and the same folder appears in the Meta’s workspace, so the Meta can read the outputs while the Task still runs. Every teamhub command that the AlterEgo runs goes to its own Task, because .teamhub/cli/config.json in its workspace names that Task. Follow-ups from the Meta and the answers to its approval cards reach it through a private Inbox, not through files. Agent memory learns from the Meta’s conversation. A report enters that conversation, so what a report says can become memory. The steps inside a Task do not.

​

How does the agent keep you posted on a long Task?

Linger watches the quiet time between reports. A report wakes the Meta as soon as a turn ends, but one turn can run for a long while, and the chat would hear nothing.

1. Linger notices the silence. A Task of this Room is running or waiting for an approval, and the agent has said nothing in the Room for 10 minutes.
2. Linger reminds the Meta in private. The reminder lists each Task with how long it has run, when it last reported, any approvals it waits for, and its latest step.
3. The Meta decides. When something is worth telling you, it checks the Task with teamhub task check and posts one short update in its own words. When nothing that matters has changed, it says nothing.

A reminder that leads to silence doubles the next wait: 20 minutes, then 40, up to 2 hours. Any change resets the wait to 10 minutes, whether the agent speaks or the Task reports, takes a new step, or asks for an approval. Linger sends no reminder while the agent is in the middle of a reply, and none while a voice call handles the work. You never see the reminder itself, only the update that the agent chooses to post.

​

How does a new request reach a running Task?

You tell the Meta, and the Meta passes your request to the same Task with teamhub task send. It does not start a second Task for the same work. When you ask how a Task is going, the Meta checks it with teamhub task check and tells you how it really stands. When you ask it to stop, teamhub task stop ends the current turn and keeps the files, so a later request can pick the work up again. Your answer on an approval card goes straight to the AlterEgo. The Meta does not relay it.

​

Keep learning