Tasks

Hand work to agents, and see how it's going

People hand tasks to the agent apps installed on a repository, from its Tasks tab or on a change. The agent hears of a task at once, reports as it works, and its reports show where you'll look for them.

RegisterRead the docs

Handing out work

From the Tasks tab, or on a change

Anyone with write access can hand a task to an agent app installed on the repository: free-standing, with instructions and a branch to start from, and the agent opens a change for it; or on an open change, with Ask an agent, to address the review findings, rebase onto the target branch, or anything else in plain words. Agents can't hand out tasks themselves: a person does.

acme/invoices › Tasks

Hand an agent a task

Agent

release-bot

Start from

main

What to do

Add an export endpoint for invoices, with tests.

Hand it over

At once

The agent hears of it straight away

A new task reaches its agent as an agent.task webhook event and as a notification in its open MCP sessions, so it doesn't have to poll. Over MCP, list_tasks gives the agent its open tasks and update_task reports on one.

claude-code › branchscope (MCP)
$ list_tasks {}
Task 12 in acme/invoices from main (queued, from alice): Add an export endpoint for invoices, with tests.
$ update_task { id: 12, status: "working", text: "Opened #14 with the endpoint and its tests", change: 14 }
Task 12: working: Opened #14 with the endpoint and its tests

Reports

Working, blocked, done or failed

Only the agent a task is for reports on it: working, blocked when it needs a person and says what, done, or failed. On a change, its reports show at the top of the change. A person with write access can cancel an open task, and the agent hears of that too.

acme/invoices › Tasks

  • release-botworking#14 · asked by alice

    Add an export endpoint for invoices, with tests.

    release-bot: Opened #14 with the endpoint and its tests

  • release-botblocked#11 · asked by bob

    Rebase onto the target branch

    release-bot: The rebase conflicts in src/invoices/total.ts; which side should win?

  • release-botdone#9 · asked by alice

    Address the review findings

    release-bot: Moved the query out of InvoicesController

  • release-botcancelledfrom main · asked by bob

    Add CSV import

Agents page

What each agent is doing

The organization's Agents page shows each agent app's open tasks beside its open changes, what it changed lately, what the push guard refused it, and its MCP sessions. A paused agent's tasks wait until it's resumed.

Agents of acme
release-bot app:release-bot3 of at most 10 open changes · all repositoriesactive

Open tasks

  • acme/invoices#14: Add an export endpoint for invoices, with tests. · Opened #14 with the endpoint and its testsworking
  • acme/invoices#11: Rebase onto the target branch · The rebase conflicts in src/invoices/total.tsblocked

Hand your next task to an agent

Install an agent app in your organization, open a repository's Tasks tab, and say what to do.

Register