Skip to content

GitButler Release Notes

GitButler Inc · A macOS Git client for working with simultaneous branches alongside an existing workflow.

CaskDeveloper ToolsAuto-updates
Install command
brew install --cask gitbutler
30-day installs
373
#493 in App
1-year installs
3.2K
Last 365 days
Latest version
0.23.5
Download size
49MB
gz
Release cadence
Weekly
6 releases in 30 days
  1. 0.23.5

    LatestPatch

    OpenNavo editorial Added to Homebrew

    GitButler 0.23.5, published on November 20, 2026, fixes Windows amend and stack push failures for people working on several branches at once.

    Fixes
    Fixes a second amend on Windows, a 0.23.3 regression.Fixes pushing a stack after branches merge together.
    CLI
    Adds but worktree recycle for a clean archived worktree.
    Native
    Allows separate light and dark themes.Restores the last place after an update or crash.

    GitButler 0.23.5 fixes branch, stack, and Windows commit operations for people who keep several branches in flight on top of their Git workflow. Published on November 20, 2026. Source: https://github.com/gitbutlerapp/gitbutler/releases/tag/release/0.23.5

    • Ships a verified Flathub package for Linux, with the native app included.
    • Fixes a second amend, reword, or move into the same commit on Windows, a regression from 0.23.3 that failed with "Failed to find commit … in rebase editor".
    • Makes committed symlinks from Windows work on Linux and macOS.
    • Fixes pushing the rest of a stack after several of its branches merge, which failed with "There are no new commits between base branch …".
    • Stops deleting the last applied branch from detaching HEAD when main has moved on.
    • Stops a large project far behind upstream from using gigabytes of memory while loading.
    • Adds but worktree recycle, which reuses a clean archived worktree and keeps its build output.
    • In the native app, allows separate light and dark themes, restores the last place after update or crash, and lets a dragged branch become its own stack.
  2. 0.23.4

    Patch

    OpenNavo editorial Added to Homebrew

    GitButler 0.23.4, for people working on several Git branches at once, stops warning Git LFS and git-crypt repos away and adds commit diffs plus a command terminal in the native app.

    Git
    Git LFS and git-crypt repos are no longer told to avoid GitButler.Those repos are covered only for editing and resolving commits.GitHub auto-merge works when a repo allows only squash or rebase.Anthropic requests no longer fail with 401 when using GitButler's key.
    CLI
    but apply, squash, show and pr suggest a next step when they refuse.
    App
    The Graph tab shows a commit diff, with keys and a right-click menu.New terminal with… (⌘I) opens a terminal running a command you pick.Appearance adds a preset, accent, corner style and density.Recycle worktree reuses a clean archived worktree instead of a new one.⇧⌘P opens the command palette, not the Create pull request form.A plain git commit on gitbutler/workspace no longer breaks the project.
    Install
    Linux .deb and .rpm installs send you to the downloads page to update.A deleted or moved project folder is named and can be removed.

    GitButler 0.23.4, released November 11, 2026, is a Git client for working on several branches at once. This version stops warning Git LFS and git-crypt repositories away, and adds commit diffs, a command terminal, and appearance controls in the native app.

    Source: https://github.com/gitbutlerapp/gitbutler/releases/tag/release/0.23.4

  3. 0.23.3

    Patch

    OpenNavo editorial Added to Homebrew

    GitButler 0.23.3 updates linked worktrees with the workspace, preserves conflicting uncommitted changes, and adds split panes and direct diff editing in the experimental native app.

    GitButler 0.23.3, a Git client for parallel branches and worktrees, updates linked worktrees together with the workspace and keeps conflicting uncommitted changes as conflict markers. Source: https://github.com/gitbutlerapp/gitbutler/releases/tag/release/0.23.3

    • Updating the workspace also updates linked worktrees.
    • Conflicting uncommitted changes in linked worktrees are kept with conflict markers.
    • Repositories owned by another user explain how to allow access with safe.directory.
    • Branch apply, unapply, and update write usable file contents in git-crypt and Git LFS repositories.
    • Combining branches based on different target commits no longer creates unnecessary conflicts or incorrect file contents.
    • The but CLI accepts Git-style paths, and but commit runs Git commit hooks again in the main checkout.
    • The experimental native app adds split panes, top tabs, a command editor, but://open links, and direct editing of working-tree files in the diff.
  4. 0.23.2 (3329)

    Expand

    OpenNavo editorial

    GitButler 0.23.2(2026-11-02)修复暂存文件处理、目标分支跟踪及工作树和合并请求问题。

    GitButler 0.23.2 was released on 2026-11-02. This update fixes staged-file handling, missing target-branch tracking and several worktree, merge-request and CLI issues.

    Fixes

    • Commits and amendments no longer disturb staged files or hide later file edits.
    • Fixed problems caused by missing target-branch tracking: older projects failing to open, missing pull request details and skipped remote updates.
    • The app now refreshes after external worktree changes and no longer shows errors for worktrees removed outside the app.
    • Merged pull requests no longer disappear from worktree branches after the workspace is updated.
    • Undo no longer leaves newly created branches behind or fails to restore deleted branches after Git garbage collection.
    • GitLab: fixed merge request listing on older instances and authentication with server URLs ending in /api/v4/.
    • Bitbucket: fixed pull request creation and browser links for remotes using ssh.bitbucket.org.
    • Unstacking failures with linked worktrees are fixed, and branches no longer disappear from the native app when unstacked.
    • but open is removed; use but gui or but ..

    CLI

    • but agent setup now supports Amp, and but agent uninstall removes GitButler skills and instructions from coding agents.
    • Claude desktop agents can enable Auto-fix for pull requests created with but pr new in workspace mode.
    • but worktree new --above now accepts branch names, IDs and Git revisions.
    • but resolve gains clearer recovery hints and checks for leftover conflict markers.
    • but branch delete now handles branches outside the workspace and protects branches checked out in linked worktrees.

    Experimental

    • Adds integrated terminals for each checkout, with agent status indicators and drag-and-drop support.
    • Adds a commit graph showing the workspace, linked worktrees and target history.
    • Adds in-app pull request editing, auto-merge on creation and clearer CI checks.
  5. 0.23.2
  6. 0.23.0

    Expand

    OpenNavo editorial Added to Homebrew

    Works in any Git repository without setup, adds linked worktree support, and expands CLI and TUI workflows.

    • Works in any Git repository without setup, using gitbutler/workspace only when a second parallel branch is applied.
    • Adds linked worktree support in the CLI and GUI, with worktree commands for creating, listing, archiving, restoring, and removing worktrees.
    • Uses a local target branch, supports repositories without a remote, and improves refresh speed and commit signing, including SHA-256 repositories.
    • Replaces but land with but merge (keeping the alias), removes but setup, and adds but split.
    • Adds TUI worktree and commit operations, including hunk-level actions, and fixes workspace loading, partial commits, undo, pushes, and forge authentication.

    https://github.com/gitbutlerapp/gitbutler/releases/tag/release/0.23.0

  7. 0.22.3

    Expand

    OpenNavo editorial Added to Homebrew

    Fixes incorrect forge-authentication errors during sync, obscured GitHub pull request publishing errors, and a regression affecting the configured Git identity.

    Fixes
    Corrects auth errors when syncing without a connected forge.Shows GitHub's explanation for pull request publishing failures.Fixes fallback committer use instead of the configured Git identity.

    GitButler 0.22.3 fixes three issues. Syncing a project without a connected forge integration no longer produces an incorrect GitHub or GitLab authentication error. When publishing a GitHub pull request fails, the app now shows GitHub's explanation of what needs fixing instead of the generic “422 Unprocessable Entity” message. This release also fixes a regression from 0.22.2 that caused the app, in some cases, to use a fallback committer value rather than the configured Git identity.

    Source: https://github.com/gitbutlerapp/gitbutler/releases/tag/release/0.22.3

  8. 0.22.2

    Expand

    OpenNavo editorial Added to Homebrew

    Workspace updates now fast-forward local target branches after remote advances. This release also fixes pull and merge request loading, workspace sync, conflict handling, branch operations, and other issues, and changes CLI and TUI behavior.

    Fixes
    Workspace updates fast-forward local target branches after remote advances.Fixes pull and merge request loading, display, and refresh issues.Fixes sync, conflict, uncommitted-change, and branch-operation failures.
    CLI/TUI
    Use but tui --diff; but diff --tui and but config ui were removed.TUI adds branch mode, branch search, and branch creation and switching.Commits can now be moved to a new branch.

    Updating a workspace now fast-forwards a local target branch, such as main, when its remote branch advances.

    This release fixes several pull and merge request problems, including refreshes for GitHub repositories with 100 or more open pull requests, loading GitLab merge requests without a head commit, and keeping request details visible when credentials are missing or a network refresh fails. It also corrects misleading mergeability status while checks are loading or unavailable.

    Other fixes cover non-UTF-8 conflict handling, overlapping staged and unstaged changes, workspace sync when an unused remote cannot be fetched, slow fetch/push/clone operations, onboarding without a configured Git identity, and stack and upstream branch operations.

    The diff TUI option is now invoked as but tui --diff. The but diff --tui and but config ui commands were removed. In the TUI, b enters branch mode; users can discard, search, create, and switch branches, position new branches relative to another branch, and move commits to a new branch.

    Source: https://github.com/gitbutlerapp/gitbutler/releases/tag/release/0.22.2

  9. 0.22.1

    Expand

    OpenNavo editorial Added to Homebrew

    Adds conflict-resolution, branch, CLI, and TUI capabilities, alongside fixes across workspaces, GitHub/GitLab integrations, and command-line workflows.

    Features
    Resolve conflicts while keeping both versions of affected files.Add CLI conflict tools, branch targeting, aliases, and path-based discard.Expand TUI navigation, branch actions, and diff rendering.
    Fixes
    Fix workspace, rebase, commit, and branch-stack issues.Fix GitHub/GitLab errors, listings, and merge-request behavior.Fix push reporting, remote URLs, and stale file or diff displays.

    GitButler 0.22.1 adds ways to handle conflicts without losing either version: the app and but pull retain both versions when target-branch updates conflict with uncommitted work, and the CLI adds tools to inspect and resolve conflicts, including conflicts in commits without checking them out. CLI changes also expand branch targeting and positioning, add aliases and path-based discard, and make push results and error handling more informative. The TUI gains direct switching among commit, squash, and move modes, more entry points into diffs, branch uncommit, and cherry-picking.

    The release fixes workspace problems involving branch dragging, landing, and upstream squash-merges; rebase and reword conflict-state errors; and incorrect handling of clean commits and stale files. It also addresses GitHub and GitLab listing and merge issues, push failures or misleading results, self-hosted forge links over SSH on non-standard ports, and several branch-view and project-setup errors. On macOS, holding ⌘ while selecting a project indicates that it opens in a new window.

    Official release notes

  10. 0.22.0
  11. 0.21.2
  12. 0.21.1
  13. 0.21.0
  14. 0.20.4
  15. 0.20.3
  16. 0.20.2
  17. 0.20.1
  18. 0.20.0
  19. 0.19.13
  20. 0.19.12
  21. 0.19.11
  22. 0.19.10
  23. 0.19.9
  24. 0.19.8