jjwt

A workspace manager for jujutsu repositories. Inspired by worktrunk and config-compatible with it, jjwt is an independent implementation written from scratch in Rust, tailored to jujutsu's native concepts (workspaces, bookmarks, revsets).

Install

Cargo

cargo install --git https://github.com/endoze/jjwt

Nix

Add jjwt as a flake input and apply its overlay:

{
  inputs.jjwt.url = "github:endoze/jjwt";

  outputs = { nixpkgs, jjwt, ... }: {
    # Apply the overlay so pkgs.jjwt is available everywhere
    nixosConfigurations.myhost = nixpkgs.lib.nixosSystem {
      modules = [{
        nixpkgs.overlays = [ jjwt.overlays.default ];
        environment.systemPackages = [ pkgs.jjwt ];
      }];
    };
  };
}

Works the same way in home-manager — apply the overlay, then add pkgs.jjwt to home.packages.

Or run directly without installing:

nix run github:endoze/jjwt

Homebrew

brew install endoze/tap/jjwt

Then set up your shell:

# Fish
jjwt config shell init fish > ~/.config/fish/functions/wt.fish

# Bash (add to ~/.bashrc)
eval "$(jjwt config shell init bash)"

# Zsh (add to ~/.zshrc)
eval "$(jjwt config shell init zsh)"

This creates a wt shell function that wraps jjwt so that wt switch can cd into the target workspace.

Shell completions

# Fish
jjwt config completions fish > ~/.config/fish/completions/jjwt.fish

# Bash (add to ~/.bashrc)
eval "$(jjwt config completions bash)"

# Zsh (add to ~/.zshrc, before compinit)
jjwt config completions zsh > "${fpath[1]}/_jjwt"

Quick start

cd my-jj-repo

# Create a config file
jjwt config create --project

# Create a new workspace (no existing bookmark)
jjwt switch --create feat/my-feature

# Switch to a workspace for an existing bookmark (auto-creates)
jjwt switch feat/existing-branch

# List all workspaces
jjwt list

# Remove a workspace
jjwt remove feat/my-feature

# Remove the current workspace
jjwt remove

Commands

switch <name>

Switch to a workspace. If the workspace doesn't exist but a bookmark with that name does, the workspace is created automatically. Use --create only for entirely new branches.

jjwt switch feat/login          # switch or auto-create from bookmark
jjwt switch --create new-idea   # create workspace + new bookmark
jjwt switch ^                   # switch to trunk
jjwt switch -                   # switch to previous workspace
jjwt switch @                   # current workspace (useful with -x)
jjwt switch pr:42               # checkout a GitHub PR by number
jjwt switch mr:12               # checkout a GitLab MR by number

remove [names...]

Remove one or more workspaces. Omit names to remove the current workspace.

list

Show all workspaces with status, diff stats, and trunk relationship.

jjwt list                       # table view
jjwt list --branches            # include bookmarks without workspaces
jjwt list --remotes             # include remote-only bookmarks
jjwt list --full                # add CI status + LLM summaries
jjwt list --format json         # machine-readable output
jjwt list --format statusline   # compact one-liner for shell prompts

The table adapts to your terminal width — columns are prioritized and low-value ones drop on narrow terminals.

hook

Run a configured hook manually, or inspect all hooks.

jjwt hook my-hook               # run a hook by name
jjwt hook --show                # list all configured hooks
jjwt hook --show --expanded     # show hooks with templates rendered
jjwt hook --show --source user  # show only user-level hooks
jjwt hook --var KEY=VAL         # inject extra template variables

config

Manage jjwt configuration.

jjwt config create --project    # scaffold .config/wt.toml
jjwt config create --user       # scaffold ~/.config/jjwt/config.toml
jjwt config show                # display resolved config (both layers)
jjwt config shell init fish     # emit shell wrapper function

step utilities

Low-level tools for scripting and automation.

Aliases

Define custom aliases in your config and invoke them as subcommands:

[aliases]
greet = "echo Hello from {{ branch }} ({{ args | join(' ') }})"

jjwt greet world    # => Hello from main (world)

Configuration

jjwt reads config from two layers, merged together:

1. User config — ~/.config/jjwt/config.toml (defaults, personal hooks)
2. Project config — .config/wt.toml in the repo root (shared with team)

User config can also contain [projects."host/owner/repo"] blocks that override settings per-repository.

Example .config/wt.toml

worktree-path = ".worktrees/{{ branch | sanitize }}"
background-remove = true

[pre-start]
setup = "npm install"

[post-switch]
notify = "echo Switched to {{ branch }}"

[aliases]
wip = "jj describe -m 'wip: {{ branch }}'"

[commit.generation]
command = "claude -p --no-session-persistence"

[list]
summary = true

Hooks

Hooks run at lifecycle points: pre-switch, post-switch, pre-start, post-start, pre-remove, post-remove. They support template rendering with variables like {{ branch }}, {{ repo }}, {{ worktree_path }}, {{ vars.KEY }}, and more.

Project-sourced hooks require approval on first run (stored in ~/.config/jjwt/approvals.toml). Set JJWT_TRUST_PROJECT_HOOKS=1 to bypass in CI.

Template filters

License

MIT licensed. See LICENSE for details.

Some template filters were ported from worktrunk by Maximilian Roos (MIT / Apache-2.0). Attribution is preserved in the respective source files.