release/0.20.4
leaningtech/webvmrelease/0.20.4Jun 26, 2026by krlvi
AI Summary
A major feature update for GitButler adding an interactive agent setup wizard, TUI improvements, and new CLI commands.
Key Highlights
- Introduced `but agent setup` wizard for easier configuration.
- Added ability to reorder stacks and apply branches directly in the TUI.
- Added `--changes` flag to `but amend` and font size settings for diffs.
- Hunk IDs are now stable across commits and discards.
Breaking Changes
- Removed the `but mark` and `but unmark` commands
New Features
- Interactive agent setup wizard
- TUI stack reordering
- Font size setting for diff views
- Stable Hunk IDs
Full Release Notes
## Agentic Use There is now a new command `but agent setup` which makes the overall setup easier. It is an interactive wizard for tuning version control behavior (similar to https://docs.gitbutler.com/ai-agents/tuning-agent-behavior but easier to setup). Running this is a good idea for best performance. - Multi-committing, amending and splitting of commits now complete quicker and use less tokens - Improved PR stacking workflows ## Changes - There is now a "Font size" setting for the diff views (Settings → Appearance) ## CLI - `but amend` now accepts `--changes` to amend specific changes into a commit - You can now provide a message when creating an empty commit with `but commit` - `but uncommit` now supports a diff output option to print the resulting changes - `but status` now shows stacked branches that have been merged upstream - Hunk IDs are now stable across commits and discards - `but completions` now appears in the help output, making it discoverable when you grab the `but` binary without an installer - `but` output now labels "unassigned changes" as "uncommitted" - Fixes a bug where `but apply` could report success while leaving a branch unapplied when workspace metadata was stale - Removed the `but mark` and `but unmark` commands - Improved error messages when `stdin` isn't a terminal ## TUI - You can now reorder stacks in the TUI - You can now apply branches from the TUI - You can now move multiple commits at once in the TUI - You can now commit above or below the selected commit in the TUI - You can now copy more things in the TUI — commit details, diff hunks, branch names and more — with `shift+y` - Improved scroll keybindings: `j`/`k`/arrows move by line, `ctrl+d`/`ctrl+u` jump by 10 lines, and `shift+j`/`shift+k` jump by section - Unapplying a branch and undoing no longer prompt for confirmation in the TUI, since both can be undone ## Fixes - Fixes a bug where moving empty branches did not work correctly - Fixes a bug where commit-message and branch-name generation failed for non-OpenAI providers (Anthropic, Ollama, and others) - Fixes an issue where commit signing failed when `gpg.ssh.program` pointed at a path containing a tilde (`~`) - Fixes an issue where being offline produced repeated error toasts from background pull-request polling - Fixes an issue where updating the workspace was not handling squash-merge integrated branches properly ## New Contributors * @ameyypawar made their first contribution in https://github.com/gitbutlerapp/gitbutler/pull/14245 * @tobeycodes made their first contribution in https://github.com/gitbutlerapp/gitbutler/pull/14348 **Full Changelog**: https://github.com/gitbutlerapp/gitbutler/compare/release/0.20.3...release/0.20.4 ## Downloads Download bins from https://gitbutler.com/