Skip to main content

Worktrees

A worktree is a working copy of one project on one node, called a slot. Every task runs in a slot, so a project can run as many tasks at once as it has free slots.

Where worktrees fit​

Slots sit between three other parts of Jaah:

  • Projects. A project's slots live on its nodes: All, or its node groups, picked in the project's Settings tab, section Nodes. See Run a project on some nodes only.
  • Nodes. The machines slots live on, which build each slot themselves. A node's details show how many slots it holds and which tasks hold them. See How nodes work.
  • Tasks. A starting task takes a free slot and keeps it until it is completed, deleted or reset, so a task you stop and start again picks up the work already in its slot. When every slot is held, a new task waits as Queued. See How tasks work.

If tasks often sit in Queued, the project needs more slots. Each subtask of an epic takes a slot of its own too; see How epics and features work.

Pages in this section​

Changing a project's slots and nodes needs the org admin role; see How team and access work.