release/0.17.0

gitbutlerapp/gitbutlerrelease/0.17.0Oct 30, 2025by krlvi

AI Summary

A major release introducing full Gerrit support, GitHub credential configuration for different projects, and CLI enhancements including shell auto-completion and experimental workspace Codegen features.

Key Highlights

  • Full Gerrit support with GUI and CLI integration
  • Ability to configure different GitHub credentials for different projects
  • CLI auto-completion setup support
  • Experimental 'Codegen (workspace)' feature toggle

Breaking Changes

  • The `but` binary is now the same as the one that launches the UI (for improved compatibility) - it will be necessary to re-link it from the app settings

New Features

  • Gerrit support
  • GitHub credential configuration
  • CLI auto-completion
  • Submodule support
  • Codegen workspace toggle

Full Release Notes

## Gerrit support
GitButler now supports working Gerrit remotes. Docs: https://docs.gitbutler.com/features/gerrit-mode
- Commits and pushes are performed in the way that a Gerrit server expects them 
- Adding topics, hashtags, status is supported
- Review URLs are accessible from GitButler
- Accessible with both the GUI and the CLI

## GitHub integration
- It is now possible to configure different GitHub credentials (eg. Work and Private) for different projects in the app
- It is no longer required to be logged in with a GitButler account to be able to configure a GitHub integration. 

## CLI
- You can now setup a shell auto completion `eval "$(but completions zsh)"` (NB: replace zsh with your shell of choice and add this to your respective `~/.zshrc` file)
- It is now possible to push with the CLI (`but push --help`)
- Status can now display code review status (`but status -r) (GitHub and Gerrit supported)
- When referencing branch names, ambiguity is now gracefully handled.

## CLI Breaking changes
- The `but` binary is now the same as the one that launches the UI (for improved compatibility) - it will be necessary to re-link it from the app settings)

## Codegen (Claude Code)
- There is now an experimental feature toggle "Codegen (workspace)" which enables the ability to use Claude Code directly from the workspace (in-line with branch and commit data)
- It is now possible to reference project files (begin typing @filename for fuzzy searching)
- Pressing enter can produce a new line (and Cmd/Control + Enter submits) - this can be enabled in the settings

## Other changes
- GitLab - Fixes an issue where "create merge request" does nothing
- Adds Haiku as a commit/branch name generation model option
- Fixes an issue where when setting a new base branch did not perform a checkout
- Improved submodule support

## New Contributors
* @vitallium made their first contribution in https://github.com/gitbutlerapp/gitbutler/pull/10662
* @homburg made their first contribution in https://github.com/gitbutlerapp/gitbutler/pull/10734

**Full Changelog**: https://github.com/gitbutlerapp/gitbutler/compare/release/0.16.10...release/0.17.0

## Downloads
Download bins from https://gitbutler.com/