Free a held slot
When a project's new tasks sit in Queued although nothing seems to be running, its slots are probably held by tasks that are waiting: a question nobody answered, a task you stopped. A slot stays with its task until that task is completed, deleted or reset, so stopping it is not enough. Find the holder on the node, then let it go.
Who can do this: seeing who holds a node's slots needs the permission to view worktrees. Completing or resetting a task needs edit access to its project; deleting it needs permission to delete tasks.
Find the holder
-
In the sidebar, select Directory, then Machines; the Nodes tab opens.
-
Select the node the project runs on. Its Overview tab opens.
-
Read Slots (how many slots the node holds) and Held (which tasks hold them). Held names each task by its number, for example 2 by #4815, #4816, and marks the ones waiting for your answer with asking. When every holder is waiting for you, it says so: 2 tasks waiting for your answer.
-
Select a task number under Held to open that task.
Let it go
- Decide what the task still needs:
- It is asking you something. Answer it. The task carries on in its slot and frees it when it finishes.
- Its work is finished, or no longer wanted. Open its ⋯ menu and select Complete, Reset (back to a clean draft, after you confirm) or Delete.
- Go back to the node's Overview: the task is gone from Held, and a Queued task of the project can take the slot.
Stop keeps the slot on purpose, so a task you start again carries on with its work. Each action is described in Stop, restart or reset a task.
Related
- How worktrees work — who holds a slot, and for how long.
- Give a project more slots — when the project needs more slots, not fewer holders.
- Nodes — every field on a node's Overview tab.