GitKraken Desktop Documentation

GitKraken Desktop Release Notes

This release notes page tracks what’s new and changing in the current version of GitKraken Desktop, including new features, improvements, bug fixes, and deprecations. Use it to see what shipped in the most recent release, confirm when a capability became available, or review changes before upgrading.

Requirements and limits

  • This page covers the current major version of GitKraken Desktop. For earlier releases, see the archived version pages (Version 11, Version 10, Version 9, and earlier).
  • Each entry applies only to the specific release listed under its version heading.
  • Use the current feature documentation for step-by-step guidance and the release notes to confirm version timing.

Download Current Version Now

Check out our GitKraken Roadmap to see what we’re working on.


Version 12.3.0

Tuesday, July 7th, 2026

New ✨

  • Unified GitKraken login and integration management:
    • Sign in and sign up now happen through your browser at gitkraken.dev, replacing the in-app email/password form.
    • New integration connections will now be connected through your GitKraken account and synced across all your devices. You can manage integrations for your GitKraken account at gitkraken.dev as well as from Preferences > Integrations.
    • Note: Integrations and login for On-premise clients (both Self-Hosted and Serverless) have not been modified and will continue to be managed locally.
    • Multiple WIP nodes in the Commit Graph:
    • A WIP node now appears in the Commit Graph for every worktree with uncommitted changes or an active agent session. Each WIP row shows the summary of changes, and β€” for any worktree other than the one you’re currently in β€” an agent’s status when a session is active there. Toggle visibility in Preferences > Agents.
    • Selecting the WIP row for another worktree will expose an inline “Open Worktree” action so you can easily switch to that worktree.
  • Review PRs with GitKraken Code Review:
    • The in-app pull request review mode has been replaced with links to a more full-featured review experience on gitkraken.dev. GitKraken Code Review hosts a powerful diff viewer that visualizes moved code, AI-powered overviews and suggestions, and a chat interface to ask questions. Access it from the Launchpad, Pull Requests in the Left Panel, or the Graph.

Improvements πŸ™Œ

  • When checking out a branch or commit, any WIP (if present) will be automatically selected, so you can prepare your first commit immediately.
  • Added text search to filter the worktree list in the Agent Sessions view by branch or directory name.
  • Hardened HTML sanitization in the markdown file preview so embedded scripts and iframes in repository content are no longer rendered.
  • GitKraken Desktop now shows an error when the file watcher stops receiving file change events from the operating system, instead of silently missing external changes until the app regains focus.
  • Added zoom controls (Increase Zoom, Decrease Zoom, Reset Zoom) to the View menu, with the zoom range extended to include 250% and 300%.
  • Cloud-connected clients can now sign out of their GitKraken account from the profile menu or the OS menu bar.
  • GitKraken AI:
    • The usage details now shows your organization’s shared credit pool, with a breakdown of your usage, the rest of the org’s usage, and remaining credits β€” plus a notice when you’ve hit your personal weekly limit.
    • Removed retired Claude 4 models (Claude 4 Sonnet, Claude 4 Opus) as options in Preferences > GitKraken AI. Users previously using these models will be automatically migrated to Claude 4.6 Sonnet.
    • Added new Claude model options in Preferences > GitKraken AI when using your own API key: Claude 4.5 Sonnet, Claude 4.5 Haiku, and Claude 4.8, 4.7, 4.5, and 4.1 Opus.

Bug Fixes πŸ›

  • Fixed an issue where the Sign In link in the top-right corner of the onboarding flow did not work on macOS.
  • Fixed an issue where a “create another profile” message appeared inside the SSH settings during onboarding after connecting an integration.
  • Fixed an issue where the diff view’s navigation and display controls (Inline/Split/Hunk, ignore whitespace, and word wrap) were disabled for UTF-16 encoded files.
  • Fixed an issue where the file tree collapsed when comparing the WIP commit with another commit and the app refreshed.
  • Fixed an issue where the Agents view worktree list briefly flickered (emptied and then repopulated) when switching to another worktree.
  • Fixed an issue where the “Open this worktree” and “Open worktree in new tab” context menu options were missing for locked worktrees in the Worktrees section of the left panel.
  • Fixed an issue where adding a pre-existing SSH key to an integration could display the wrong key name, which risked removing the wrong key from the provider.
  • Fixed an issue where a valid SSH key could be shown as invalid when a GitHub integration account has more than 100 SSH keys.
  • Fixed an issue where wide markdown content (long lines, large images, or code blocks) in the file preview was centered and could not be scrolled horizontally to view the full content.
  • Fixed an issue where starting an agent session from the Agents view worktree menu left the terminal unfocused, so typing did not reach the agent until you clicked into the terminal.

Version 12.2.1

Tuesday, June 16th, 2026

Improvements πŸ™Œ

  • The embedded terminal now dims slightly when focus is elsewhere in the app, making it clearer where keystrokes will land.
  • Merged PR pills now also appear for GitLab merge requests in the Toolbar, Commit Details panel, and worktree cards, so you know when a branch’s work has shipped.

Bug Fixes πŸ›

  • Fixed an issue where multi-selecting the WIP and a commit in the graph showed the wrong diff for a specific modified file.
  • Fixed an issue on Windows where comparing the WIP with a commit could show an entire file as changed because of line-ending differences.
  • Fixed an issue where multi-selecting the WIP and a commit in the graph prevented the navigation of files with the keyboard from working correctly.
  • Fixed an issue where GitKraken could spawn background processes uncontrollably while a terminal was open on macOS.
  • Fixed an issue where committing inside a submodule outside of GitKraken Desktop did not refresh the parent repository’s WIP view.
  • Fixed an issue where the Diff View of a selected WIP file kept showing stale content after the file changed externally, showing outdated commit information for submodules.

Version 12.2.0

Tuesday, June 2nd, 2026

Improvements πŸ™Œ

  • Agent Sessions view:
    • Added live status support for OpenCode agent sessions.
      • Navigate to Preferences > External Tools to install or uninstall the OpenCode plugin for reporting live agent status.
    • The New Agent Session button now starts a session immediately with generated defaults, while customization options remain available from the split button menu.
  • Added a “Rebase onto this commit” option when right-clicking a commit that has no branches.

Bug Fixes πŸ›

  • Fixed an issue where switching between Inline, Split, and Hunk views in the File History panel had no effect when File History was opened from a file’s context menu.

Version 12.1.2

Tuesday, May 19th, 2026

Improvements πŸ™Œ

  • Agent Sessions view:
    • Added sort and filter controls to the worktree list so you can quickly focus on the sessions that matter. Narrow down by status or branch to keep large groups of parallel agent sessions manageable at a glance.
  • GitHub Pull Requests:
    • Merged PRs now surface as a pill on the Toolbar, Commit Details panel, and worktree cards for their associated branches, giving you instant confirmation that a branch’s work has shipped, so you know when it’s safe to clean up local branches and worktrees.

Bug Fixes πŸ›

  • Fixed an issue where extensionless image files were not correctly identified in commit diffs, showing them as editable.
  • Fixed repeated “Staging paths failed” errors when rebasing across a file/directory name collision.
  • Fixed an issue where profile and repository management row menus could be visually cut off.

Version 12.1.1

Thursday, May 7th, 2026

Improvements πŸ™Œ

  • Worktrees:
    • You can now remove the active worktree directly; GitKraken will switch back to the main worktree before removing it.

Bug Fixes πŸ›

  • Fixed an issue where GitKraken Desktop could get trapped on the splash screen and fail to start.

Version 12.1.0

Tuesday, May 5th, 2026

Improvements πŸ™Œ

  • Worktrees:
    • New worktrees and agent sessions now inherit view settings (hidden refs, hidden remotes, soloed refs/remotes, and collapsed folders/remotes) from the source repository, so you no longer need to re-hide branches and remotes after creating a worktree.
    • Added a “Remove worktree and delete branch” action to the worktree context menu for one-step cleanup of worktrees and their associated branches.
  • Agent Sessions view:
    • Added a three-dot action menu to worktree cards in the Agents Left Panel view.
    • You can now start an agent session directly from an existing worktree’s context menu.
    • Refined the New Agent Session form so options are always visible and the branch, coding agent, and Start Session controls are easier to use.
    • The base branch selector in the New Agent Session form is now searchable.
    • A new “Running” status appears when an agent session starts (Claude Code may show a different status if hooks are enabled).
    • Added visual feedback on worktrees in the Agents view to show a worktree deletion is in progress.
  • Command Line:
    • You can now open a repository by passing its path directly as an argument (e.g. gitkraken . or gitkraken /path/to/repo) without needing the --path flag.
  • Review GitHub Pull Requests on GitKraken.dev:
    • Added a “Review on GitKraken.dev” button in the GitHub Pull Request view to open a PR with GitKraken Code Review. Review PRs faster with cleaner diffs, AI-generated suggestions, and integrated chat β€” approve and comment just like on GitHub.
  • Terminal:
    • The embedded terminal now resizes smoothly when adjusting surrounding panels.
    • You can now minimize the integrated terminal, keeping the terminal panel header visible.
    • You can now kill terminal sessions directly from the trash icon in the terminal panel header.
  • Added zoom levels 140%, 150%, 175%, and 200% to the standard zoom options in the status bar.
  • Upgraded Electron to v41.

Bug Fixes πŸ›

  • Fixed an issue where Bitbucket Cloud repositories were not listed in the clone dialog due to a deprecated API endpoint removal.
  • Fixed an issue where active agent sessions could stop showing the “Needs response” status while waiting for user input.
  • Fixed an issue when selecting an old commit in the file history view that made the application crash.
  • Fixed an issue where the interactive rebase editor did not show a scrollbar when needed.
  • Fixed an issue where diffs were rendered with all lines shown as additions when diff.noprefix = true was set in the git config.

Version 12.0.1

Saturday, April 18th, 2026

Improvements πŸ™Œ

  • You can now uninstall and reinstall Claude Code hooks used to display live agent status in the Agents Session View from Preferences > External Tools.

Bug Fixes πŸ›

  • GitKraken will no longer attempt to automatically install Claude Code hooks after they are removed.
  • Fixed an issue in 12.0.0 where GitKraken On-Premise and Standalone clients were attempting to send telemetry via the GitKraken CLI.

Version 12.0.0

Tuesday, April 14th, 2026

“A special agent with a license to commit.”

New ✨

  • Agent Sessions View – Manage, create, and monitor parallel AI agent sessions from a single panel:
    • The new Agent Sessions View in the Left Panel gives you a unified dashboard for your worktrees and active agent sessions. Each worktree is represented as a card showing its branch, uncommited changes, ahead/behind state, and associated PRs so you can monitor multiple agents at a glance.
      • If using Claude Code, the associated agent’s status will show in the card so you know when it’s working, waiting for input, or errors.
    • The “New Agent Session” action creates a worktree, runs your configured setup commands, and launches your coding agent in one step β€” making it easy to start a parallel task in a new, isolated environment.
      • Add setup commands in Preferences > Agents to configure per-worktree setup commands (dependency installs, build steps, env file copies) so new agent environments are ready to go automatically.
      • Configure your preferred coding agent in the inline options menu when creating a new agent session, or go to Preferences > External Tools to set your agent and pass custom CLI arguments when starting agent sessions. This setting currently supports Claude Code, Codex CLI, OpenCode, Copilot CLI, and Gemini CLI (auto-detected based on installation).
    • Added a setting in Preferences > UI Customization to hide the Agent view toggle in the Left Panel.
  • Terminal – An upgraded terminal that keeps your entire workflow in one window:
    • Added multi-session support to the embedded terminal, allowing independent terminal sessions per worktree in a single tab. Switching worktrees will switch to the relevant terminal session automatically.
    • Added drag-and-drop support for files and text into the terminal.
    • Updated default terminal color theme for improved readability and contrast.
    • Upgraded the terminal engine (xterm.js) from v4 to v6, bringing a handful of major improvements:
      • Significantly faster rendering with optimized WebGL and DOM renderers, reducing main-thread blocking during buffer resizing.
      • Improved glyph rendering with multi-page texture atlas support, removing the previous hard cap on glyph storage.
      • Better Unicode and emoji rendering, including fixes for clipped italic emoji and wide character handling.
      • Added support for ligatures, additional Powerline glyphs, and new underline styles (dashed, dotted, overline).
      • Synchronized output to prevent flicker during rapid terminal updates.

Improvements πŸ™Œ

  • GitKraken AI:
    • Added support for Claude Sonnet 4.6 and Claude Opus 4.6 when using your own API key.
    • Added support for Google Gemini 3.1 Pro (Preview) when using your own API key.
    • Removed deprecated Claude 3.x models (Claude 3.7 Sonnet, Claude 3.5 Sonnet, Claude 3.5 Haiku, Claude 3 Haiku, Claude 3 Opus) from AI preferences. Users previously on these models will be automatically migrated to Claude 4.6 Sonnet.
  • Shallow Clone Settings:
    • You can now set shallow clone options when adding a remote to a repository which is shallow-cloned.
  • Repository Management Tab:
    • Added resizable columns for repo name, remote, and branch in the Repo Management tab. Column widths persist across app restarts.
  • Command Palette:
    • Added all detected IDEs as “Open in…” options in the Command Palette (Cmd/Ctrl + P).
  • Worktrees:
    • Added an option to open a worktree in a new tab from the worktree context menu and the post-creation prompt.

Bug Fixes πŸ›

  • Fixed visual issues with the terminal panel not properly resizing to fill the available space.
  • Fixed an issue where the content of stashes created from the command line with unstaged changes were not displayed in the right panel.
  • Fixed an issue where LFS file tags were not shown for files located in subdirectories.
  • Bitbucket users can once again assign multiple reviewers when creating a pull request.
  • Fixed an issue where commit diffs appeared empty when the commit contained only whitespace changes and “Ignore Leading/Trailing Whitespace” was enabled.
  • Fixed an issue where typechanged files were missing their diff icon and not appearing in the staged/unstaged area.
  • Fixed an issue where the terminal panel would jump to the top of the viewport when switching repositories or worktrees.
  • Added visual feedback and prevented duplicate actions when deleting a worktree from the left panel.
  • Fixed an issue where columns in the ‘All Repositories’ group on Repo Management were horizontally misaligned with other groups.
  • Fixed visual issues with the terminal panel styling and padding.
  • Fixed an issue where committed file diffs showed all lines as additions when color.ui = always was set in the git config.

Known Issues

  • Users running GitKraken Desktop in WSL may experience issues when starting agent sessions. Windows-installed coding agents can take precedence over WSL-installed ones, causing the agent to fail to run.
  • When cloning Bitbucket repositories, the repository list may not appear in the Clone modal due to a Bitbucket API deprecation. As a workaround, you can clone the repository by pasting its URL directly, or browse and clone repositories from the Repository Management tab.

Have feedback about this article? Did we miss something? Let us know!
On this page