Jujutsu

Jujutsu (jj) integration for Sublime Text.

Jujutsu provides status bar information and jj commands accessible via the command palette. It is designed for colocated repositories (where both .jj and .git exist), letting Sublime's built-in git integration handle diff gutters and other git-specific features while Jujutsu adds jj workflow commands.

Features

• Status bar: Shows current change ID, description, and bookmark information
• Command palette integration: Common jj operations available via quick commands

Requirements

• Sublime Text 4
• Jujutsu installed and available in PATH (or configured via settings)

Installation

Package Control

1. Open the command palette (Ctrl+Shift+P / Cmd+Shift+P)
2. Run "Package Control: Install Package"
3. Search for "Jujutsu" and install

Manual Installation

1. Clone or download this repository
2. Copy the Jujutsu folder to your Sublime Text Packages directory:
   • macOS: ~/Library/Application Support/Sublime Text/Packages/
   • Linux: ~/.config/sublime-text/Packages/
   • Windows: %APPDATA%\Sublime Text\Packages\
3. Restart Sublime Text

Commands

All commands are available via the command palette (Ctrl+Shift+P / Cmd+Shift+P) with the "JJ:" prefix.

Basic Operations

Running Commands Across a Stack

"JJ: Run Command on Revset..." runs a shell command once per change in a revset (default configurable via run_default_revset). Each change is checked out into a private working copy by jj run --ignore-changes, so neither the commits nor your working copy are modified. Results appear in an output panel: a PASS/FAIL line per change, captured output for failures, and a final summary. The per-change timeout is configurable via run_command_timeout (default 600 seconds). Requires jj 0.43 or later.

Restoring and Discarding Changes

Both operations are recorded in the operation log, so they can be undone with "JJ: Undo Last Operation" or "JJ: Operation Log (Restore)...".

Squash Operations

Navigation and History

Conflicts

The status bar also flags conflicts: the current change gets a (conflict) marker, and a count of other conflicted mutable changes is appended when present.

Log View

"JJ: Log View" opens a persistent, read-only tab showing the jj log graph. The view uses jj's configured default revset unless log_view_revset is set. The following keys act on the change under the cursor:

The view refreshes automatically after each operation. Entries are syntax highlighted: change ids, bookmarks, conflict and empty markers, and author lines each pick up theme colours.

Further chrome:

• Hovering an entry shows a detail card with the full description, author, timestamps, a diff stat, and clickable edit/diff/squash/abandon actions.
• Right-aligned annotations show each entry's relative age, bookmarks, and working-copy or conflict markers.
• The entry under the cursor is outlined, making the target of key presses unambiguous.
• The gutter marks the working copy (circle) and conflicted entries (dot).

Workspaces

Workspaces are additional working copies attached to the same repository, each with its own working-copy commit.

jj does not record workspace directory paths, so the list command cannot open existing workspaces' folders; only newly created workspaces are opened automatically.

Bookmark Management

Tag Management

Requires jj 0.44 or later (tags are tracked like bookmarks).

Git Integration

Pull and Retrunk

The "Pull and Retrunk" command runs jj git fetch followed by jj rebase -d trunk() -s roots(trunk()..stack(@)). This requires the following revset aliases in your jj config:

[revset-aliases]
'trunk()' = 'latest((present(main) | present(master)) & remote_bookmarks())'
'stack()' = 'stack(@)'

Settings

Configure Jujutsu via Preferences > Package Settings > Jujutsu > Settings or by editing Jujutsu.sublime-settings:

{
    // Path to jj executable. Set to null to auto-detect from PATH.
    "jj_path": null,

    // Enable status bar with current change ID and description.
    "status_bar_enabled": true,

    // Debounce delay in seconds for updates after save.
    "debounce_delay": 0.5,

    // Enable debug logging.
    "debug": false
}

Key Bindings

Jujutsu does not define default key bindings to avoid conflicts with other packages. To add your own, go to Preferences > Key Bindings and add entries from the suggestions below.

Suggested Shortcuts

These are convenient bindings for the most common operations. Copy whichever you find useful into your user key bindings:

[
    { "keys": ["ctrl+shift+n"], "command": "jj_new" },
    { "keys": ["ctrl+shift+c"], "command": "jj_commit" },
    { "keys": ["ctrl+shift+d"], "command": "jj_describe" },
    { "keys": ["ctrl+shift+z"], "command": "jj_undo" },
    { "keys": ["ctrl+shift+s"], "command": "jj_quick_squash" },
    { "keys": ["ctrl+shift+l"], "command": "jj_squash" },
    { "keys": ["ctrl+shift+r"], "command": "jj_rebase" }
]

All Available Command Names

• jj_new
• jj_describe
• jj_commit
• jj_split
• jj_squash
• jj_squash_interactive
• jj_quick_squash
• jj_absorb
• jj_absorb_interactive
• jj_abandon
• jj_undo
• jj_op_log
• jj_conflicts
• jj_conflicted_files
• jj_restore_file
• jj_discard_interactive
• jj_log_view
• jj_file_history
• jj_annotate_file
• jj_evolog
• jj_git_push
• jj_git_fetch
• jj_duplicate
• jj_revert
• jj_tag_list
• jj_tag_set
• jj_tag_delete
• jj_fix
• jj_file_search
• jj_parallelize
• jj_run
• jj_workspace_list
• jj_workspace_add
• jj_workspace_forget
• jj_workspace_rename
• jj_workspace_update_stale
• jj_pull_retrunk
• jj_edit
• jj_log
• jj_rebase
• jj_refresh
• jj_bookmark_set
• jj_bookmark_move
• jj_bookmark_delete
• jj_bookmark_rename
• jj_bookmark_list
• jj_git_push_change

Jujutsu Documentation

• Command Reference
• Revset Language
• Fileset Language

Licence

Blue Oak Model Licence 1.0.0 - See LICENCE for details.