GitKraken Client Documentation

Downloads  
Contact support  
Feedback  
GitKraken.com  

GitKraken Client Release Notes

Behold the evolution of GitKraken Client! Find out what’s new, what’s fixed, or just take a trip down memory lane with a nostalgic swagger, remembering those bugs of yesterday.

Download Current Version Now

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

Version 9.0.1

“The only thing more constant than software bugs, is the need to fix them.”

Wednesday, January 4th, 2023

Improvements 🙌

  • The Open repo command in the Command Palette will now show repos from deep linking and Local Workspaces.

Bug Fixes 🐛

  • Fixed a bug on MacOS where having the UI theme set to Sync with system caused high CPU usage.
  • Workspaces:
    • Issues will now load in Workspace when using GitHub Issues or GitLab Issues.
    • GitKraken Insights metrics section will still show even if there are no open PRs.
    • Fixed blank Workspace tab that would show after upgrading to 9.0.
  • Fixed issue saving token when a user manually enters the token to login with GitHub.
  • Submodules:
    • Fixed error when discarding all changes after adding a submodule.
    • Fixed submodule not initializing after renaming a submodule.
    • Fixed submodule not initializing when discarding all changes with submodule changes.
  • Fixed performance hit when undoing Discard all changes with LFS files.
  • Fixed lag when resizing the commit message.

Version 9.0.0

Tuesday, December 13th, 2022

“Ready to tear into presents? Santa’s “Workspace” has been coding around-the-clock to release these gifts 🎁”

We know how tedious it can be to figure out what repos have recent WIPs and which repos to open next. That’s why we’re so excited to present GitKraken Client 9.0, and transform your development workflow.

This version helps you create a hub for all your repos and makes working with multiple repos a breeze. Plus, with features like Workspaces and GitKraken Insights, you’ll be able to improve your development productivity in no time.

New

  • Workspaces ✨

    • There are now two types of GitKraken Workspaces: Local and Cloud.
    • Local Workspaces are a new type of Workspace that reference only repositories on your machine.
      • Select individual repositories, a directory of repositories, or a VS Code Workspace (.code-workspace) to create a Local Workspace.
      • Local Workspaces can also be created from existing Project Directories in the Repository Management view.
      • Quickly open repositories in a Repo Tab, or in a VS Code Workspace.
      • View the currently checked out branch, remote status, and work in progress across all repositories in the Workspace.
      • View repository details, including the README for each repository in the Workspace.
      • Fetch all repositories in a Workspace at once.
    • Cloud Workspaces (previously Personal and Shared) are enhanced with Pull Requests and Issues from hosting and issue tracking services.
      • Cloud Workspaces can be easily created from Local Workspaces from the Workspace menu.
      • The Overview is now out of Preview and has been renamed to the Focus View. It displays Pull Requests, Issues, and work in progress that are relevant to you.
      • The Team Overview is now out of Preview and has been renamed to the Team View. It displays Pull Requests and Issues for everyone on your team.
      • Tables inside the Focus View and Team View can now be customized to toggle specific columns on/off.
    • Repositories can now be marked as favorites within all Workspaces.
  • GitKraken Insights – Preview

    • GitKraken Insights measures how fast pull requests are merged into your repositories and more! Get metrics like:
      • Average Cycle Time: Measures the average time it takes for a pull request to be merged for the selected timeframe.
      • Average Throughput: Measures the average number of pull requests merged for the selected timeframe.
      • Merge Rate: The percentage of merged pull requests compared to open pull requests for the selected timeframe.
      • Open: The total number of pull requests opened for the selected timeframe.
      • Merged:The total number of pull requests merged for the selected timeframe.
    • Note: GitKraken Insights will be gradually rolled out to all users. Look for it soon!
  • Ghost branches 👻

    • A “ghost” branch is now displayed when hovering over commits in the graph that shows the closest branch in the BRANCH / TAG column. This can be toggled on/off in Preferences > UI Customization.
  • Commit highlighting 💡

    • Now when you hover over a branch/tag, the associated commits will be highlighted on the graph after a brief delay. This can be toggled on/off in Preferences > UI Customization.
  • Solo from the graph 🔍

    • You can now solo branches directly from the context menu of branches in the graph, which hides all other branches and commits.

Improvements 🙌

  • Workspaces 🗂
    • The Create Workspace form has been refined to include Local and Cloud Workspace types and to make sharing and adding repositories easier.
    • The Workspace loading spinner is less-boring 🍭
    • Improved speed at which Focus View and Team View start to load.
  • Left Panel ⬅️
    • Resizing sections in the Left Panel now behaves better in edge cases, like pushing several sections at once.
    • Sections in the Left Panel can now be maximized via context menu to collapse all other sections.
    • Icons and text in the Left Panel have been aligned and have consistent indents in all sections.
    • The resize handle for adjusting Left Panel width is now centered on the panel edge.
  • UI / Themes 🎨
    • The UI has been refreshed in most views to reduce visual noise. This mostly involved reducing the dependency on background colors to separate sections of content and will be noticeable in custom themes.
    • Color values in default Light themes have been updated to be generally brighter.
    • Color values in the Dark (High Contrast) theme have been updated to better separate content after the UI refresh.
    • Menu bar and context menus will now match the GitKraken Client theme in Windows.
  • The Mac application icon has been updated to match current Apple guidelines.
  • Windows and Linux application icons have also been refreshed.
  • Improved LFS performance for cherry-picking or reverting a commit with a large amount of LFS files.

Bug Fixes 🐛

  • Fixed an issue where submodules were left uninitialized (even with ‘Keep submodules up to date’ enabled in the preferences) after the following actions:
    • Undo or redo a checkout or reset hard
    • Cherry-pick, revert, rebase, interactive rebase, reset, pull
  • Fixed some theme-ability issues on the toolbar and the New Tab.
  • Fixed an issue with false positives in private repo detection.
  • Fixed an error that will occur when Ctrl/Shift clicking within the Left Panel.

Workspaces

Local Workspaces

GitKraken Client 9.0 brings a whole new way to organize your repos. Users may now create Local Workspaces to group repositories on your machine.

To create a Local Workspace, navigate to the Workspace tab in the upper left of GitKraken Client and click on New Workspace.

Select Local Workspace and then name your Workspace, and browse to select repos to add to your Local Workspace.

Once your Local Workspace is created, you’ll see all your repos grouped together and get the following benefits:

  • View currently checked out branch for each repo.
  • Click on any repo name to open it as a tab in GitKraken Client.
  • Multi-select repos to:
    • Perform a fetch for the selected repos
    • Open repos as tabs in GitKraken Client
    • Use your selection to create a Cloud Workspace (formerly called Personal or Team Workspace)

That’s right! You can also use your Local Workspace to create a Cloud Workspace, which will enable more visibility into your pull requests, issues, and share your Workspace with teams.

Cloud Workspaces

Formerly known as Personal and Shared Workspaces, Cloud Workspaces are useful for sharing your Workspace with teams along with enabling GitKraken Insights.

Focus View & Team View

The Focus View, which was previously called the Overview, is now out of Preview and provides a list of all Pull Requests, Issues, Works in Progress that matter to you.

With this release, you may now toggle columns on or off from this gear in the top left corner.

The Team Overview is also out of Preview and is now called Team View. It will show you all pull requests and issues associated with the repos in your Workspace.

And similar to the Focus View, you may now toggle columns on or off from this gear in the top left corner.

GitKraken Insights

Next, we’re excited to introduce GitKraken Insights – which measures how fast pull requests are merged into your repositories.

But why does it matter if you track metrics like pull request Cycle Time and Throughput?

“I think an underlying principle that exists is that the longer your code stays away from being merged, the more complicated your workflow is going to become.And so as those changes land and your PR and your change becomes more behind from the main trunk branch, the more likely it becomes you will have to do more work to get that code working again.”

  • Jeff Schinella, Director of Product

To enable GitKraken Insights, you’ll first need to open a Cloud Workspace and then navigate to the Pull Request section. From here, click to connect to your remote hosting service.

Once the connection is complete, return to the Pull Request section in your Cloud Workspace to view the following metrics for your Workspace pull requests:

  • Average Cycle Time: Measures the average time it takes for a pull request to be merged for the selected timeframe.
  • Average Throughput: Measures the average number of pull requests merged for the selected timeframe.
  • Merge Rate: The percentage of merged pull requests compared to open pull requests for the selected timeframe.
  • Open: The total number of pull requests opened for the selected timeframe.
  • Merged: The total number of pull requests merged for the selected timeframe.

GitKraken Insights is currently in Preview, and we’d love to hear your feedback.

UI/UX Refresh

Next, we recently released the Commit Graph for GitLens where we learned how to improve the graph even more. We’re delighted to bring those learnings to GitKraken Client 9.0.

Ghost Branches

In GitKraken Client, you will now see a “Ghost” branch when you hover over a commit. This will show the closest branch that contains that commit. The “Ghost” branch will also show when a commit is selected, and double-clicking that ghost branch will checkout the head of the referenced branch.

Users may toggle this setting on or off from Preferences > UI Customization.

Commit highlighting

When you hover over a branch, the app will highlight all commits referenced by that branch.

Users may toggle this setting on or off from Preferences > UI Customization.

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