jj workspace add creates colocated Git worktrees
Introduced 2026-10-07 · score 0.97
HOW TO USE IT
When adding a workspace in a Git-backed repository, use `jj workspace add --colocate <destination>` to create a corresponding Git worktree or `--no-colocate` to prevent one; without either flag, creation depends on whether the current workspace is colocated and `git.colocate` is true.
jj workspace add --colocate <destination>jj workspace add --no-colocate <destination>WHY THIS HELPS
When adding a workspace alongside Git worktrees, configure whether `jj workspace add` creates a corresponding Git worktree.
REQUIREMENTS AND LIMITATIONS
- Version: v0.46.0
- <destination> (required): Directory path where the new workspace is created.
- --colocate: Create a Git worktree alongside the new workspace.
- --no-colocate: Do not create a Git worktree alongside the new workspace.
- git.colocate: Boolean configuration setting used for default colocation; the release note says the default creates a worktree when the current workspace is colocated and this setting is true.
- Prerequisite: Git command version 2.42.0 or later; `jj workspace add` uses `git worktree add --orphan`, introduced in Git 2.42.0.
- The default colocates only when the current workspace is colocated and `git.colocate` is `true`.
FIRST-PARTY EVIDENCE
- https://github.com/jj-vcs/jj/releases/tag/v0.46.0
- https://github.com/jj-vcs/jj/discussions/10339
- https://github.com/jj-vcs/jj/blob/main/cli/src/commands/workspace/add.rs
Check the installed version and the source before using it. Entry JSON