About
jj is a Git-compatible version control system that is both simple and powerful. See
the installation instructions to get started.
Release highlights
- Jujutsu can now colocate workspaces besides the default one by creating Git
worktrees. Usejj workspace add --[no-]colocateand the setting
git.colocateto control this.
Breaking changes
-
The minimum supported
gitcommand version is now 2.42.0, up from 2.41.0.
jj workspace addusesgit worktree add --orphan, which was added in
2.42.0. -
The minimum supported Rust version (MSRV) is now 1.97.1.
-
jj bisect runnow runs some consistency checks before proceeding to bisect.
This helps ensure that the command can tell good and bad revisions apart,
and that the working copy does go from bad to good over the provided revset.
Use the new flag--trust-endpointsto disable these checks. -
jj splitnow opens a single editor session to edit descriptions for the
split commits. -
jj undoandjj redonow refuse to undo/redo an operation that was
performed in another workspace. Use--allow-cross-workspaceto undo/redo
it anyway. -
jj workspace list/rootno longer omit unreachable paths. All recorded
paths are now shown, with warnings displayed injj workspace root. -
The
List.get(),.first(), and.last()template functions now return
Option<T>instead of throwing an error on out-of-bounds access.
New features
-
jj workspace addsupports--colocate/--no-colocateflags to control
whether a Git worktree is created alongside the workspace. The default
colocates when the current workspace is colocated and thegit.colocate
config istrue.jj workspace forgetremoves the corresponding Git
worktree when one exists. -
jj git colocation status/enable/disablenow work on child
workspaces.statuscorrectly reports colocation state and includes
the workspace name.enablecreates a Git worktree anddisable
removes it, allowing colocation to be toggled after workspace
creation. -
jj workspace removeremoves a workspace and its directory from disk. The
working-copy state is snapshotted into a commit before removal. -
Added commands
jj file editandjj file deletefor editing files in any
revision without needing to change the working copy. -
jj git pushnow supports pushing to multiple remotes at the same time.
This can be configured viagit.pushset to a string pattern
or array of string patterns, or with the repeatable--remoteflag,
which also accepts string patterns. -
The default target revisions for
jj git pushcan now be configured via
revsets.git-push. -
Added the
TreeEntry.normal_value()template method and theTreeValuetype
to access resolved tree values, formatted as their full object IDs, including
Git submodule commit IDs. -
Diff hunk headers now include nearby source symbols for many common
programming and markup languages. -
fix.tools.<name>.line-range-args(replacesline-range-arg) is an array of
string template args to pass to the fix tool. This is more flexible in cases
where you need to pass multiple arguments to the tool, such as separate args
for the range start and range end. -
jj runnow uses the sparse patterns from the workspace it's run from.
Use the--sparse-patternsoption to control this behavior (evaluated
per eachjj runinvocation). -
jj util diff <path1> <path2>to compare files on disk. -
Aliases now support setting
aliases.<name>.enabled = false, which will
disable them. This can be used to disable built-in aliases or disable aliases
in later layers (such as repo config files). -
ui.editornow supports$pathand$linesubstitution variables. Example:
ui.editor = ["emacs", "+$line", "$path"] -
filltemplate function now supports an additional named parameter
break_words, that allows specifying if the template should break words
longer thanwidthpassed in the input to ensure no words overflow the
specified width. -
The
json()template function now supports map literals:json({'key' => value}) -
The hunk headers of
diff.color-words.conflict = "pair"now include the
conflict labels of the compared terms.
Fixed bugs
-
On Windows,
jjno longer hangs when a subprocess needs to prompt the user,
such assshasking for a key passphrase or for confirmation of an unknown
host key. Subprocesses started from a terminal now inherit its console, rather
than being given an invisible one byCREATE_NO_WINDOWfor the prompt to
disappear into.
#6745
#8547 -
On Windows,
jj git colocation enableandjj git colocation disableno
longer fail with "Access is denied (os error 5)" when the Git repository
contains pack files.
#8661 -
jj undoofjj workspace forgetnow correctly preserves the workspace's
recorded path. Previously the path metadata was lost, leaving the workspace
in a broken state after undo.
#9991 -
at_operation()can now be used with operations that are not ancestors of
the current operation (e.g. sibling operations created by concurrent
commands). Previously, evaluating such expressions failed if they resolved
to commits missing from the current operation's index. -
.gitignorefiles are now respected even if they aren't materialized in the
working copy because they are excluded by the sparse patterns. Previously,
ignored files could become tracked in a sparse working copy.
#2289 -
In-tree ignore files (
.gitignore) are no longer read through symlinks,
matchinggitbehavior. Such files are now silently skipped instead of having
their symlink target applied.$GIT_DIR/info/excludeandcore.excludesFile
are unaffected and still follow symlinks, asgitdoes.
#7161 -
jj workspace listtemplates are now labeled withworkspace name,
workspace root, etc.
Contributors
Thanks to the people who made this release happen!
- Aaron Bies (@slerpyyy)
- Austin Seipp (@thoughtpolice)
- Bartok9 (@Bartok9)
- Brice Figureau (@masterzen)
- Bryan O'Sullivan (@bos)
- Caleb White (@calebdw)
- David Rieber (@drieber)
- Farid Zakaria (@fzakaria)
- Gabriel Goller (@kaffarell)
- Gasper Stukelj (@mirkomartn)
- Jakub Stasiak (@jstasiak)
- JamBalaya56562 (@JamBalaya56562)
- Joseph Lou (@josephlou5)
- Karnajeet Gosavi (@kg290)
- LOG (@logarithmone1128)
- Martin von Zweigbergk (@martinvonz)
- Matt Stark (@matts1)
- Mustafa Officewala (@genericusername2709)
- pederbe (@pederbe)
- Philip Metzger (@PhilipMetzger)
- Pro (@twistedfall)
- Remo Senekowitsch (@senekor)
- Sami Hiltunen (@SamiHiltunen)
- sofia (@badp)
- Stephen Jennings (@jennings)
- Vincent Ging Ho Yim (@cenviity)
- xtqqczze (@xtqqczze)
- Yannik Sander (@ysndr)
- Yuya Nishihara (@yuja)