Worktree Backend

Host-level execution using isolated Git worktrees without containers.

In environments where Docker or Podman cannot run (such as certain constrained CI runners or machines without virtualization support), NIKI provides a fallback Worktree Backend.

niki run "Refactor helper functions" --backend worktree

How It Works

1. NIKI creates an isolated Git worktree under .niki-worktrees/<task-id>.
2. Code modifications and test commands run as direct host processes inside that worktree directory.
3. NIKI captures the diff, applies it to the host working tree, then creates and commits the eligible niki/<id> branch before cleaning up the temporary worktree.