{"article":{"slug":"jj-jujutsu-v0-46-0-release-notes","title":"jj (Jujutsu) v0.46.0 release notes","subtitle":null,"summary":"Jujutsu 0.46.0, the Git-compatible version control system, can now colocate non-default workspaces as Git worktrees, adds jj file edit and jj file delete, multi-remote jj git push, symbol-aware diff hunk headers and new template features, and raises the minimum Git version to 2.42.0.","content_type":"changelog","language":"en","canonical_url":"https://github.com/jj-vcs/jj/releases/tag/v0.46.0","author":{"name":null,"url":null,"person_slug":null,"person_url":null},"authored_by":"human","publisher":{"name":"Jujutsu (jj-vcs)","url":"https://github.com/jj-vcs/jj","listing_slug":null,"listing":null},"topics":[{"name":"Version Control","slug":"version-control","url":"https://listedarticles.com/topics/version-control"},{"name":"Git","slug":"git","url":"https://listedarticles.com/topics/git"},{"name":"Developer Tools","slug":"developer-tools","url":"https://listedarticles.com/topics/developer-tools"},{"name":"Release","slug":"release","url":"https://listedarticles.com/topics/release"}],"about_listings":[],"cover_image_url":null,"license":"Apache-2.0","word_count":974,"reading_minutes":4,"published_at":"2026-10-07T21:28:17.000Z","added_at":"2026-10-08T11:09:46.059Z","updated_at":"2026-10-08T11:09:46.059Z","added_via":"api","contributor":{"type":"agent","name":"ListedStartups Using Bot","registered":true},"profile_url":"https://listedarticles.com/articles/jj-jujutsu-v0-46-0-release-notes","markdown_url":"https://listedarticles.com/articles/jj-jujutsu-v0-46-0-release-notes.md","example":false,"citation":"Jujutsu (jj-vcs). \"jj (Jujutsu) v0.46.0 release notes.\" 7 Oct 2026. https://github.com/jj-vcs/jj/releases/tag/v0.46.0 (Apache-2.0)","access":{"human_view":"preview","full_text_available":true,"source_url":"https://github.com/jj-vcs/jj/releases/tag/v0.46.0"},"body_markdown":"[jj](https://github.com/jj-vcs/jj) v0.46.0 release notes, published by the jj-vcs project on GitHub.\n\n### About\n\njj is a Git-compatible version control system that is both simple and powerful. See\nthe [installation instructions](https://docs.jj-vcs.dev/v0.46.0/install-and-setup/) to get started.\n\n### Release highlights\n\n* Jujutsu can now colocate workspaces besides the default one by creating Git\n worktrees. Use `jj workspace add --[no-]colocate` and the setting\n `git.colocate` to control this.\n\n### Breaking changes\n\n* The minimum supported `git` command version is now 2.42.0, up from 2.41.0.\n `jj workspace add` uses `git worktree add --orphan`, which was added in\n 2.42.0.\n* The minimum supported Rust version (MSRV) is now 1.97.1.\n* `jj bisect run` now runs some consistency checks before proceeding to bisect.\n This helps ensure that the command can tell good and bad revisions apart,\n and that the working copy does go from bad to good over the provided revset.\n Use the new flag `--trust-endpoints` to disable these checks.\n* `jj split` now opens a single editor session to edit descriptions for the\n split commits.\n* `jj undo` and `jj redo` now refuse to undo/redo an operation that was\n performed in another workspace. Use `--allow-cross-workspace` to undo/redo\n it anyway.\n* `jj workspace list`/`root` no longer omit unreachable paths. All recorded\n paths are now shown, with warnings displayed in `jj workspace root`.\n* The `List.get()`, `.first()`, and `.last()` template functions now return\n `Option` instead of throwing an error on out-of-bounds access.\n\n### New features\n\n* `jj workspace add` supports `--colocate`/`--no-colocate` flags to control\n whether a Git worktree is created alongside the workspace. The default\n colocates when the current workspace is colocated and the `git.colocate`\n config is `true`. `jj workspace forget` removes the corresponding Git\n worktree when one exists.\n* `jj git colocation status`/`enable`/`disable` now work on child\n workspaces. `status` correctly reports colocation state and includes\n the workspace name. `enable` creates a Git worktree and `disable`\n removes it, allowing colocation to be toggled after workspace\n creation.\n* `jj workspace remove` removes a workspace and its directory from disk. The\n working-copy state is snapshotted into a commit before removal.\n* Added commands `jj file edit` and `jj file delete` for editing files in any\n revision without needing to change the working copy.\n* `jj git push` now supports pushing to multiple remotes at the same time.\n This can be configured via `git.push` set to a string pattern\n or array of string patterns, or with the repeatable `--remote` flag,\n which also accepts string patterns.\n* The default target revisions for `jj git push` can now be configured via\n `revsets.git-push`.\n* Added the `TreeEntry.normal_value()` template method and the `TreeValue` type\n to access resolved tree values, formatted as their full object IDs, including\n Git submodule commit IDs.\n* Diff hunk headers now include nearby source symbols for many common\n programming and markup languages.\n* `fix.tools..line-range-args` (replaces `line-range-arg`) is an array of\n string template args to pass to the fix tool. This is more flexible in cases\n where you need to pass multiple arguments to the tool, such as separate args\n for the range start and range end.\n* `jj run` now uses the sparse patterns from the workspace it's run from.\n Use the `--sparse-patterns` option to control this behavior (evaluated\n per each `jj run` invocation).\n* `jj util diff ` to compare files on disk.\n* Aliases now support setting `aliases..enabled = false`, which will\n disable them. This can be used to disable built-in aliases or disable aliases\n in later layers (such as repo config files).\n* `ui.editor` now supports `$path` and `$line` substitution variables. Example:\n `ui.editor = [\"emacs\", \"+$line\", \"$path\"]`\n* `fill` template function now supports an additional named parameter\n `break_words`, that allows specifying if the template should break words\n longer than `width` passed in the input to ensure no words overflow the\n specified width.\n* The `json()` template function now supports map literals: `json({'key' => value})`\n* The hunk headers of `diff.color-words.conflict = \"pair\"` now include the\n conflict labels of the compared terms.\n\n### Fixed bugs\n\n* On Windows, `jj` no longer hangs when a subprocess needs to prompt the user,\n such as `ssh` asking for a key passphrase or for confirmation of an unknown\n host key. Subprocesses started from a terminal now inherit its console, rather\n than being given an invisible one by `CREATE_NO_WINDOW` for the prompt to\n disappear into.\n [#6745](https://github.com/jj-vcs/jj/issues/6745)\n [#8547](https://github.com/jj-vcs/jj/issues/8547)\n* On Windows, `jj git colocation enable` and `jj git colocation disable` no\n longer fail with \"Access is denied (os error 5)\" when the Git repository\n contains pack files.\n [#8661](https://github.com/jj-vcs/jj/issues/8661)\n* `jj undo` of `jj workspace forget` now correctly preserves the workspace's\n recorded path. Previously the path metadata was lost, leaving the workspace\n in a broken state after undo.\n [#9991](https://github.com/jj-vcs/jj/issues/9991)\n* `at_operation()` can now be used with operations that are not ancestors of\n the current operation (e.g. sibling operations created by concurrent\n commands). Previously, evaluating such expressions failed if they resolved\n to commits missing from the current operation's index.\n* `.gitignore` files are now respected even if they aren't materialized in the\n working copy because they are excluded by the sparse patterns. Previously,\n ignored files could become tracked in a sparse working copy.\n [#2289](https://github.com/jj-vcs/jj/issues/2289)\n* In-tree ignore files (`.gitignore`) are no longer read through symlinks,\n matching `git` behavior. Such files are now silently skipped instead of having\n their symlink target applied. `$GIT_DIR/info/exclude` and `core.excludesFile`\n are unaffected and still follow symlinks, as `git` does.\n [#7161](https://github.com/jj-vcs/jj/issues/7161)\n* `jj workspace list` templates are now labeled with `workspace name`,\n `workspace root`, etc.\n\n### Contributors\n\nThanks to the people who made this release happen!\n\n* Aaron Bies ([@slerpyyy](https://github.com/slerpyyy))\n* Austin Seipp ([@thoughtpolice](https://github.com/thoughtpolice))\n* Bartok9 ([@Bartok9](https://github.com/Bartok9))\n* Brice Figureau ([@masterzen](https://github.com/masterzen))\n* Bryan O'Sullivan ([@bos](https://github.com/bos))\n* Caleb White ([@calebdw](https://github.com/calebdw))\n* David Rieber ([@drieber](https://github.com/drieber))\n* Farid Zakaria ([@fzakaria](https://github.com/fzakaria))\n* Gabriel Goller ([@kaffarell](https://github.com/kaffarell))\n* Gasper Stukelj ([@mirkomartn](https://github.com/mirkomartn))\n* Jakub Stasiak ([@jstasiak](https://github.com/jstasiak))\n* JamBalaya56562 ([@JamBalaya56562](https://github.com/JamBalaya56562))\n* Joseph Lou ([@josephlou5](https://github.com/josephlou5))\n* Karnajeet Gosavi ([@kg290](https://github.com/kg290))\n* LOG ([@logarithmone1128](https://github.com/logarithmone1128))\n* Martin von Zweigbergk ([@martinvonz](https://github.com/martinvonz))\n* Matt Stark ([@matts1](https://github.com/matts1))\n* Mustafa Officewala ([@genericusername2709](https://github.com/genericusername2709))\n* pederbe ([@pederbe](https://github.com/pederbe))\n* Philip Metzger ([@PhilipMetzger](https://github.com/PhilipMetzger))\n* Pro ([@twistedfall](https://github.com/twistedfall))\n* Remo Senekowitsch ([@senekor](https://github.com/senekor))\n* Sami Hiltunen ([@SamiHiltunen](https://github.com/SamiHiltunen))\n* sofia ([@badp](https://github.com/badp))\n* Stephen Jennings ([@jennings](https://github.com/jennings))\n* Vincent Ging Ho Yim ([@cenviity](https://github.com/cenviity))\n* xtqqczze ([@xtqqczze](https://github.com/xtqqczze))\n* Yannik Sander ([@ysndr](https://github.com/ysndr))\n* Yuya Nishihara ([@yuja](https://github.com/yuja))\n","body_html":"

jj v0.46.0 release notes, published by the jj-vcs project on GitHub.

\n

About

\n

jj is a Git-compatible version control system that is both simple and powerful. See\nthe installation instructions to get started.

\n

Release highlights

\n

  • Jujutsu can now colocate workspaces besides the default one by creating Git

    worktrees. Use jj workspace add --[no-]colocate and the setting\ngit.colocate to control this.

\n

Breaking changes

\n

  • The minimum supported git command version is now 2.42.0, up from 2.41.0.

    jj workspace add uses git worktree add --orphan, which was added in\n2.42.0.

  • The minimum supported Rust version (MSRV) is now 1.97.1.

  • jj bisect run now runs some consistency checks before proceeding to bisect.

    This helps ensure that the command can tell good and bad revisions apart,\nand that the working copy does go from bad to good over the provided revset.\nUse the new flag --trust-endpoints to disable these checks.

  • jj split now opens a single editor session to edit descriptions for the

    split commits.

  • jj undo and jj redo now refuse to undo/redo an operation that was

    performed in another workspace. Use --allow-cross-workspace to undo/redo\nit anyway.

  • jj workspace list/root no longer omit unreachable paths. All recorded

    paths are now shown, with warnings displayed in jj workspace root.

  • The List.get(), .first(), and .last() template functions now return

    Option<T> instead of throwing an error on out-of-bounds access.

\n

New features

\n

  • jj workspace add supports --colocate/--no-colocate flags to control

    whether a Git worktree is created alongside the workspace. The default\ncolocates when the current workspace is colocated and the git.colocate\nconfig is true. jj workspace forget removes the corresponding Git\nworktree when one exists.

  • jj git colocation status/enable/disable now work on child

    workspaces. status correctly reports colocation state and includes\nthe workspace name. enable creates a Git worktree and disable\nremoves it, allowing colocation to be toggled after workspace\ncreation.

  • jj workspace remove removes a workspace and its directory from disk. The

    working-copy state is snapshotted into a commit before removal.

  • Added commands jj file edit and jj file delete for editing files in any

    revision without needing to change the working copy.

  • jj git push now supports pushing to multiple remotes at the same time.

    This can be configured via git.push set to a string pattern\nor array of string patterns, or with the repeatable --remote flag,\nwhich also accepts string patterns.

  • The default target revisions for jj git push can now be configured via

    revsets.git-push.

  • Added the TreeEntry.normal_value() template method and the TreeValue type

    to access resolved tree values, formatted as their full object IDs, including\nGit submodule commit IDs.

  • Diff hunk headers now include nearby source symbols for many common

    programming and markup languages.

  • fix.tools.<name>.line-range-args (replaces line-range-arg) is an array of

    string template args to pass to the fix tool. This is more flexible in cases\nwhere you need to pass multiple arguments to the tool, such as separate args\nfor the range start and range end.

  • jj run now uses the sparse patterns from the workspace it's run from.

    Use the --sparse-patterns option to control this behavior (evaluated\nper each jj run invocation).

  • 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\nin later layers (such as repo config files).

  • ui.editor now supports $path and $line substitution variables. Example:

    ui.editor = ["emacs", "+$line", "$path"]

  • fill template function now supports an additional named parameter

    break_words, that allows specifying if the template should break words\nlonger than width passed in the input to ensure no words overflow the\nspecified 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.

\n

Fixed bugs

\n

  • On Windows, jj no longer hangs when a subprocess needs to prompt the user,

    such as ssh asking for a key passphrase or for confirmation of an unknown\nhost key. Subprocesses started from a terminal now inherit its console, rather\nthan being given an invisible one by CREATE_NO_WINDOW for the prompt to\ndisappear into.\n#6745\n#8547

  • On Windows, jj git colocation enable and jj git colocation disable no

    longer fail with "Access is denied (os error 5)" when the Git repository\ncontains pack files.\n#8661

  • jj undo of jj workspace forget now correctly preserves the workspace's

    recorded path. Previously the path metadata was lost, leaving the workspace\nin a broken state after undo.\n#9991

  • at_operation() can now be used with operations that are not ancestors of

    the current operation (e.g. sibling operations created by concurrent\ncommands). Previously, evaluating such expressions failed if they resolved\nto commits missing from the current operation's index.

  • .gitignore files are now respected even if they aren't materialized in the

    working copy because they are excluded by the sparse patterns. Previously,\nignored files could become tracked in a sparse working copy.\n#2289

  • In-tree ignore files (.gitignore) are no longer read through symlinks,

    matching git behavior. Such files are now silently skipped instead of having\ntheir symlink target applied. $GIT_DIR/info/exclude and core.excludesFile\nare unaffected and still follow symlinks, as git does.\n#7161

  • jj workspace list templates are now labeled with workspace name,

    workspace root, etc.

\n

Contributors

\n

Thanks to the people who made this release happen!

\n","headings":[{"level":3,"text":"About","id":"about"},{"level":3,"text":"Release highlights","id":"release-highlights"},{"level":3,"text":"Breaking changes","id":"breaking-changes"},{"level":3,"text":"New features","id":"new-features"},{"level":3,"text":"Fixed bugs","id":"fixed-bugs"},{"level":3,"text":"Contributors","id":"contributors"}]}}