Docs Configuration

workspaces.json

Whether each claimed ticket gets its own git worktree, committed in .teamtrail/workspaces.json.

Without the file, workspaces are off. Toggle them in Settings → Workspaces; dir can only be set in the file.

#Example

json
{
  "v": 1,
  "worktrees": true,
  "dir": "../worktrees"
}

#Keys

KeyTypeDefault
v1requiredFile format version.
worktreesbooleanfalsetrue gives every claimed ticket a worktree on branch teamtrail/<trail>/<n>. With false, an agent can still ask for one per claim (workspace: true).
dirfolder path../<repo>.teamtrailWhere worktrees go. A relative path starts from the repo root. Each worktree is <dir>/<trail>-<n>.

#Errors

Any other key or a wrong type is an error, shown in Settings:

text
unknown key "branchPrefix"
"worktrees" must be true or false
"dir" must be a folder path

See Parallel work for what happens on claim and completion.