fbuildCreating & running a task
Create a task, pick the project and machine, describe the goal, and an agent starts working — with its progress tracked on the board.
A task is a unit of work you hand to an agent.
Create one #
- Press
⌘T(or New task) from anywhere to open the composer. - Pick a project and, optionally, a focus — the repositories the agent should load into context.
- Choose the machine it should run on (one of your online runners).
- Describe the goal, then send it off.
The agent starts working on that machine, and you can watch it live.
The board #
The Board shows every task moving through stages — Incoming, Scope review, Building, Testing, In review (PR), and Done. From the board you can:
- See what needs your attention (a Scope review column flags tasks waiting on you).
- Filter by project.
- Click a task to open it in the task workspace (it opens beside anything you already have open).
Steering a run #
You don't have to wait. While an agent is working you can reply to steer it — your message is queued and sent as soon as the current turn finishes. Replying later resumes the same session, so the agent keeps its full context even after a restart.
Next: The task workspace — how to monitor and steer several runs at once.