hack.foo
Guides

Parallel work

Start from a configured repository. Read Worktrees and watchers before choosing shared or isolated files.

git worktree add ../project-review -b review-work
cd ../project-review
hack up --detach
hack open
hack ps

A linked worktree selects a branch instance automatically, named after the branch, with its own hostnames such as api.review-work.<project>.hack.local. A detached worktree needs an explicit --branch <name>. Stop the instance from its owning checkout when finished.

A separate branch instance does not isolate external databases, shared bind-mounted files or credentials. Coordinate with people and agents: name the checkout and branch, assign service and file ownership, and keep one owner for lifecycle operations against an instance.

On the native backend, branch selection is explicit (--branch) and needs the prepared source share described in the native reference.


Source: v5 (next.12) · docs/site/guides/parallel-work.md.