git-branchless

Initialize git-branchless in a repository

$ git branchless init

$ git sl

$ git undo

$ git sync

$ git move -s [commit] -d [destination]

$ git next

$ git prev

$ git sl --hidden

git branchless [options] command [args...]

git-branchless is a suite of tools that enhances Git for high-velocity, monorepo-scale workflows. It implements concepts from other version control systems like Mercurial and Meta's internal tools.
The smartlog (git sl) provides an intuitive visualization of your commit graph, showing only relevant commits. Unlike git log, it focuses on work in progress rather than full history.
The undo command can reverse almost any Git operation, including hard resets, rebases, and commit amendments. It maintains a hidden log of repository states.
Git-branchless uses revset expressions, a declarative language for specifying commits similar to Mercurial. This enables powerful queries like stack() (all commits in current stack) or draft() (local unpublished commits).
The move command allows relocating entire commit subtrees without affecting the working copy, automatically cleaning up obsolete branches.

-C path

Run as if started in the specified directory.

Control color output: always, never, auto.

Show hidden commits (with smartlog).

Display help information.

Show version number.

.git/hooks/

git-branchless init installs custom hooks (post-commit, post-rewrite, etc.) to track commit visibility and DAG changes.

Stores branchless-specific settings under the [branchless] section, including default revset queries and display preferences.

init

Initialize git-branchless in the repository.

Render visualization of commits you're working on.

General-purpose undo for any git operation.

Rebase all local commit stacks and branches.

Move commits to a different location in the DAG.

Check out the next commit in the stack.

Check out the previous commit in the stack.

Reapply commits after their parent was changed.

Hide a commit from the smartlog.

Unhide a previously hidden commit.

Create or update pull requests for commit stacks.

Run tests on commits in your stack.

Query commits using revset expressions.

Generate and install man pages.

Requires initialization with git branchless init in each repository. Some features modify Git hooks and configuration. Not compatible with all Git GUIs. Learning revset syntax has a curve for Git-only users.

Git-branchless was created by Waleed Khan inspired by Meta's internal Git tooling and Mercurial's evolve extension. Development began around 2021 with the goal of bringing stacked diff workflows and better undo functionality to Git. The project brings concepts like commit evolution and commit visibility to standard Git repositories.

git(1), git-absorb(1), lazygit(1), tig(1)