> ## Documentation Index
> Fetch the complete documentation index at: https://mux.coder.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Worktree Runtime
> Isolated git worktree environments for parallel agent work
Worktree runtime uses [git worktrees](https://git-scm.com/docs/git-worktree) on your local machine.
Each workspace gets its own directory, but worktrees share the same `.git` directory as your main checkout.
## How worktrees work
A worktree is a separate directory on the same filesystem as the main repository.
* It has its own working tree (files on disk) and checkout state.
* It shares a `.git` with the main repository.
Because `.git` is shared, **commits created in any worktree are immediately visible to your other worktrees (including your main checkout).**
Worktrees aren’t locked to a branch. The agent can switch branches, enter detached HEAD, or create new branches as needed. If you want to constrain branching behavior, do it via your [instruction files](/agents/instruction-files).
## Filesystem layout
Worktree workspaces are stored in `~/.mux/src//`.
Example layout:
```text theme={null}
~/.mux/src/
mux-main/
improved-auth-ux/
fix-ci-flakes/
```