jj-workspace

jj workspace (add | forget | list | rename | root | update-stale) [options] [args]

jj workspace attaches extra working copies to one repository. Each workspace is a directory with its own `.jj/` metadata and its own working-copy commit. Extra workspaces show up in `jj log` as `<workspace name>@`. A typical use is a long-running test or build in one checkout while you keep editing in another.`jj workspace add path` creates the directory, links it to the repo, and checks out a new working-copy commit. By default that commit sits on the same parent(s) as the current workspace; -r chooses different parents (including a merge if you pass several). Sparse patterns are copied from the current workspace unless --sparse-patterns says otherwise; each workspace keeps its own sparse set afterwards.`jj workspace forget` only unregisters the workspace. Delete the files yourself, before or after. A working copy becomes stale when another workspace (or an interrupted command) rewrites its commit and the on-disk files are not updated; `jj workspace update-stale` brings them back in sync, creating a recovery commit if the recorded operation was lost.

--name NAME

For add: name of the new workspace (default: basename of DESTINATION). For root: workspace to query (default: current).

Parent revision(s) of the new workspace's working-copy commit. Omit to share the current workspace's parent(s). Passing revisions is equivalent to `jj new r1 r2 ...` in the new workspace.

Description for the new working-copy commit (add).

How the new workspace inherits sparse checkout patterns. Default copy. full materializes every file; empty starts with nothing on disk.

Render each row of list. Defaults to `templates.workspace_list`.

add DESTINATION

Create a new workspace (working copy plus `.jj/` linked to the same repo) at DESTINATION.

Stop tracking the named workspace's working-copy commit. Disk files are not removed. With no names, forgets the current workspace.

Print every workspace and its available root path.

Rename the current workspace.

Print the workspace root directory (`jj root` is a shortcut).

Rewrite the working copy so it matches the operation the repo currently records for this workspace.

Subcommand of jj. Forgetting a workspace does not delete files. Rewriting workspace A's working-copy commit from workspace B leaves A's copy stale until update-stale. Each workspace has independent sparse patterns.

jj(1), jj-sparse(1), jj-new(1), jj-log(1), git-worktree(1)

Source code · Homepage · Documentation