A CLI tool for easily managing jujutsu workspaces.

• Bun runtime
• Jujutsu (jj) and a jj repository

bun i -g github:foo-x/jw

This makes the jw command available globally.

jw init

Creates .jwconfig in the repository root.

jw new <name> [-r <revision>]

• Any / in the name is automatically converted to -
• The workspace is created in <parent of default>/<repo><suffix>/<name> (suffix defaults to __ws)
• Files specified in .jwconfig are copied
• Commands specified in .jwconfig are executed

jw list

jw go [name]

Can be used with shell's cd command:

cd $(jw go <name>)

jw rm <name>

• Runs jj workspace forget
• Deletes the workspace directory

jw rename <old> <new>

jw copy <name>

Copies files specified in .jwconfig from the default workspace to the specified workspace.

jw clean

jw this

Switches the default workspace to the current workspace's revision. This is useful when you want to synchronize the default workspace with your work in another workspace.

• Must be run from a non-default workspace

jw use <name>

Switches the default workspace to the specified workspace's revision. This is useful when you want to switch to another workspace's revision from the default workspace.

• Must be run from the default workspace

jw version

source <(jw completion bash)

Create a .jwconfig file in the project root:

{
  "copyFiles": [],
  "postCreateCommands": [],
  "workspacesDirSuffix": "__ws"
}

• copyFiles: Files/directories to copy when creating a workspace
• postCreateCommands: Commands to run after creating a workspace
• workspacesDirSuffix: Suffix for the workspaces parent directory (optional)

bun install
bun link
jw <command>

MIT