Workspaces

Understanding Workspaces

Jujutsu supports multiple workspaces sharing the same repository storage. This is similar to Git worktrees but more integrated.

Workspace Transient

Key: Z / % (Vanilla) (majutsu-workspace)

Open the workspace transient.

Key: * (Evil) (majutsu-workspace)

Open the workspace transient.

Transient actions:

Key: l (majutsu-workspace-list)

List all workspaces.

Key: v (majutsu-workspace-visit)

Visit a workspace by changing default-directory and refreshing Majutsu buffers.

Key: a (majutsu-workspace-add)

Add a new workspace.

Forget option:

Key: -t

Toggle trashing workspace directories after forgetting them.

More transient actions:

Key: f (majutsu-workspace-forget)

Forget a workspace. With -t enabled, also move its local directory to the system trash after jj workspace forget succeeds; this trash step accepts local roots only, while plain forget can still forget a remotely located workspace. Before moving a directory, Majutsu verifies that the path still identifies the directory the user confirmed and does not own the shared .jj/repo store. It checks all selected workspaces and reports all paths requiring manual cleanup together.

Key: u (majutsu-workspace-update-stale)

Update a stale workspace.

Key: n (majutsu-workspace-rename)

Rename a workspace.

Key: r (majutsu-workspace-root)

Show and copy the current workspace root.

Workspace sections are rendered from a structured jj workspace list -T template. By default they show each workspace name, working-copy ids, description, and resolved root path when available. If jj cannot resolve a workspace root, Majutsu treats it as unavailable instead of showing the raw <Error: ...> text in the section body. Workspace paths containing embedded newlines or other control characters are preserved as complete values.