Build and customize
Queue several changes
Keep typing while the agent works. Your next requests wait in a Tasks list and run one after another. Reorder, remove, skip, pause and resume them.
The agent does one request at a time. You do not have to wait. While it works, type your next request and send it. It joins a list called Tasks and starts by itself when the agent is free.
Use this when you have a list of small changes and want to hand them all over at once.
Add a task to the queue
- Send a request and wait for the agent to start. The message box now says "Add a task for after this one…".
- Type your next request.
- Press Enter, or click the send button. Its tooltip now reads Add to queue.
- Your text clears and a new row appears in the Tasks list above the message box.
Add as many as you need, up to the limit below. Each task keeps the mode you had when you added it (Build or Plan) and any files you attached to it. See Plan mode and Build mode and Attach files and images.
The Tasks list
The list sits at the top of the message box. Click the Tasks heading to collapse or open it. The number next to it counts the running task and the waiting ones.
| Row | What it shows | What you can do |
|---|---|---|
| Running task | A spinner and the words of your request | Skip ends this task and moves straight on to the next one |
| Waiting task | A dot and the words of your request | Move up, Move down, Remove from the queue |
The buttons on a waiting task appear when you hover over the row or tab to it. On a touch screen they are always visible.
The list only appears when there is something in it. It is empty and hidden when the agent is idle and nothing waits.
Order of work
- The agent finishes the task it is running.
- A short moment later, the next waiting task starts. You see it as a normal message in the chat, as if you had just typed it.
- The list updates. The task moves from waiting to running, then it leaves the list.
The top task always runs first. Use Move up and Move down to change the order. A task that is already running cannot be moved.
How many tasks
You can queue up to 20 tasks. At the limit, the chat says "The list is full (20 tasks). Remove one or wait for one to finish."
Keep each task short and clear. One task, one change. A queued task follows the same 4,000-character limit as any message.
When the queue pauses
The queue stops by itself when something needs you. A line appears at the bottom of the list:
| Message | Why it paused |
|---|---|
| "Paused: you stopped the run" | You clicked Stop. Stopping ends the request and holds the line, so nothing starts without you. |
| "Paused: the last run failed" | The last request ended with an error. |
| "Paused: the last run was interrupted" | The request was cut off, for example by a lost connection. |
| "Paused: waiting for you" | The agent asked you a question, a page is broken, or database changes are waiting for your decision. |
Choose Resume to start the next task. You can also send a new message: sending a message restarts a paused queue.
If the pause is "waiting for you", deal with the card first. See Plan mode and Build mode, Approve database and server changes and Fix a page that does not load. Then choose Resume.
Plans in the queue
When you approve a plan while the agent is busy, the plan joins the list as one task. It shows the plan summary. It starts when the line reaches it, and it carries its steps with it. See Plan mode and Build mode.
Eco and the queue
Every task is a separate request. Each one uses eco in the usual way, when the agent changes files. If you run out of eco part way through, the next task cannot start. The chat tells you and the list pauses. See Eco: what it is and how it is used.
Who can use it
The queue is for signed-in users. A guest who has not signed up cannot queue tasks.
If something goes wrong
| Problem | What to do |
|---|---|
| "That didn't save. Your text is still in the box. Check your connection and try again." | Your connection dropped. Your text is still there. Send it again when you are back online. |
| A task you added does not appear | Reload the page. The list loads from your account and will show it. |
| The queue does not start the next task | Look for a "Paused" line. Choose Resume. |
| You added a task by mistake | Hover over it and choose Remove from the queue. |
| You want the whole list gone | Remove the tasks one by one, or Skip the running one and then remove the rest. |
For help writing good requests, see Write requests the agent understands.