What is a Task?

---

A Task is a piece of work you hand to an AI coding agent. You describe what you want; it writes the code, checks it, and opens a pull request for each repository it touched.

You review a pull request like any other. Nothing lands without you.

What you get back

A branch and a pull request per repository, with commits describing what changed and why. Repositories the agent didn't need to touch are left alone — no empty pull requests.

The diff lives in GitHub, GitLab or Bitbucket, where you already review code. Deployment.io shows you progress, logs and a link.

It checks its own work

Before finishing, the agent runs your build and tests and fixes what it can.

This matters more than it sounds: if those checks fail, nothing is committed and no pull request appears. The Task fails instead. You review working code, or you review nothing.

One at a time

Tasks run one at a time, in the order you created them. Start three and they'll queue — the first runs, the rest wait their turn.

Two ways to start one

Create one directly when you already know what you want. See Creating and Running a Task.

Work it out in a session first, then convert it — the Task arrives in your backlog for review before it runs. See From Spec to Task.

You can also create Tasks from your own coding agent — see Available MCP Tools.

Still deciding? A session works out what to do. A Task does it.