jj-workspaces

For a parallel environment in a jj repo, reach for a jj workspace, not a git worktree. A workspace is a second working copy backed by the same repo, so parallel tasks never fight over one checkout. djo (the dojjo tool) manages the workspace lifecycle — create, hydrate, merge, clean up — and runs hooks at each stage.

Requires a jj repo and the djo binary on PATH; see reference.md to install it or set up hooks.

Run every step from inside the repo.

1. Create the workspace

djo switch <name>

Creates a jj workspace plus a bookmark <name>, in a sibling directory ../<name> by default. cd into that directory — djo switch cannot change your shell's directory for you.

Done when djo list shows <name> and your shell is in its directory.

2. Hydrate untracked files from the original

A fresh workspace holds only jj-tracked files. Untracked, git-ignored files — node_modules, .env, build caches — are absent, so the toolchain fails until you bring them over.