Function listWorktrees

engine/src/kild/worktree.ts:107–130

(repo: string)

}

/** Create a fresh isolated worktree on a `kild/<name>` branch, force-resetting any
 *  pre-existing one. For the brain's explicit "new worktree" — NOT the session path
 *  (which must never reset a shared tree; use {@link ensureWorktree}). `name` is the
 *  kild worktree name (the branch is derived as `kild/<name>`); `base` is the
 *  start-point ref (default: current HEAD). */
export async function createWorktree(repo: string, name: string, base?: string): Promise<Worktree> {
  assertSafeBranch(name);
  const wtPath = worktreePath(name);
  const ref = worktreeRef(name);
  // Best-effort pre-clean of a same-named worktree before the force re-create.
  // Force is intentional here ("new worktree" is destructive-by-request).
  await execFile('git', ['-C', repo, 'worktree', 'remove', '--force', wtPath]).catch(() => {});
  const add = ['-C', repo, 'worktree', 'add', '-B', ref, wtPath, ...(base ? [base] : [])];
  await execFile('git', add);
  return { branch: ref, path: wtPath, name };
}

/** Create the worktree if missing, ATTACH (reuse) it if it already exists. The
 *  session path uses this — naming the same worktree as another session must join
 *  its tree, never reset it (which would blow away a coder's work when a reviewer
 *  joins). Never resets: an existing dir attaches; an existing *branch* (worktree
 *  removed but branch kept) is checked out, preserving its commits. */
export async function ensureWorktree(repo: string, name: string, base?: string): Promise<Worktree> {
  const wtPath = worktreePath(name);
  const ref = worktreeRef(name);
  const attached = { branch: ref, path: wtPath, name };
  if (existsSync(wtPath)) {