To install or update git-branchless, run the following:

$ cargo install --locked git-branchless
$ git branchless init # in your repository

If you haven't already taken the user survey, please consider doing so!

Release highlights

• git-branchless is now dual-licensed as MIT/Apache 2.0.
• Rust v1.67 or later is required to build.
• The partial commit interface (git record -i) now uses a new, more performant interface.
  • You can also access the interface directly via git branchless difftool.
• git-branchless supports repositories managed with repo (e.g. Chromium)

Changelog

Added

• (feat(move): Add --fixup to squash moved commits into the destination #545 ) EXPERIMENTAL: Added a --fixup option to git move to squash moved commits into the destination
• (feat(init): create install-man-pages subcommand #830 ) Added git branchless install-man-pages command. This may be useful for package maintainers or those who install git-branchless from source.
• (Add Phabricator support to git submit #840 ) git-branchless supports Phabricator as a backend forge for git submit.
• (smartlog: add default revset config option #845 ) Added the branchless.smartlog.defaultRevset configuration variable.
• (fix(git): simplify and generalise "symlinked .git directory" check #910 ) Added support for repositories managed by the repo tool.
• (feat(difftool): add difftool subcommand #1009 ) Added git branchless difftool subcommand.

Changed

• BREAKING (docs: relicense under MIT/Apache 2.0 #841 ): git-branchless is now dual-licensed as MIT/Apache 2.0.
• BREAKING: (docs(record): deprecate git-record as of v0.4.0 #1024 ) Rust v1.67 or later is required to build.
• (Limit fetch in submit to relevant branches #825 ) git submit only fetches the necessary branches, rather than all branches, before pushing.
• (Switch to scm-record library #826 ) Switch to scm-record crate to provide the partial commit interface.
• (feat(restack): default to draft() #914 ) The default revset for git restack is now draft().

Fixed

• (More Phabricator forge for git submit #866 ) New commits created during git rebase are no longer kept if the rebase is aborted.
• (More Phabricator forge for git submit #866 ) git test no longer clobbers working copy changes.
• (fix(amend): after amend, move detached branches pointing to current commit #876 ) After git amend, detached branches previously pointing to the amended commit are now updated.
• (fix(rewrite): fix cases of moving all parents of merge commits #915 ) Fixed certain situations of rebasing merge commits when all parents have also been rebased.
• (fix(sync): don't leave dirty index when running git sync --pull with main checked out #920 ) Running git sync when the main branch is checked out no longer leaves a dirty index.
• (Operations randomly hang and consume tons of memory #938 ) Somehow fixed mysterious hang.

New Contributors

Thanks to the following first-time contributors!

• @melko made their first contribution in tests: set an explicit value for core.abbrev config #829
• @jakejx made their first contribution in Limit fetch in submit to relevant branches #825
• @alerque made their first contribution in docs: Suggest checking package repositories before cargo install #857
• @thoughtpolice made their first contribution in feat(nix): add 'scm-diff-editor' package #978

If you're interested in contributing, check out the Developer Guide in the Wiki, or post in the Discussions or Discord server to ask any questions.