GitKraken Desktop Documentation

Workspaces in GitKraken Desktop

Last updated: January 2026

GitKraken Workspaces allow you to create easily accessible groups of repositories, take action across multiple repos, view details about their state at a glance, and share them with your team.

GitKraken Desktop showing multiple cloud Workspaces, each grouping related repositories with options to clone, locate, or manage them.
Group your repos into a Workspace

Access Your Workspaces

To access the Repo Management tab:

  1. Click on the folder icon at the top left.
  2. Or use the keyboard shortcut Alt + O (Windows/Linux) or Cmd + O (Mac).
GitKraken Desktop interface highlighting the folder icon used to access Workspaces from the Repo Management tab.
Opening Workspaces from the Repo Management tab

Cloud Workspaces

Cloud Workspaces are accessible from any machine and can be shared with selected teams in your organization. They allow for multi-repository actions and centralized pull request management.

Watch the overview:

Create a Cloud Workspace

  1. Click .
  2. Select “Cloud Workspace”.
  3. Name your Workspace and select the hosting service.
  4. Choose repositories to add.
  5. (Optional) Add an icon, description, and share with teams or users.
Highlighted 'New Workspace' button in the Repository Management view of GitKraken Desktop.
Add a new Cloud Workspace
Cloud Workspace creation form in GitKraken Desktop, showing workspace name, color selection, provider, and repository fields.
Configuring Cloud Workspace settings

Note:
The integration for the desired service must be connected under Preferences > Integrations.

Perform Multi-repository Actions

To take action across multiple repositories:

  1. Select the checkboxes next to the desired repositories.
  2. Choose an action from the toolbar at the top.
GitKraken Desktop interface showing multiple selected repositories in a workspace and the 'Fetch 3 repositories' button highlighted.
Multi-repo fetch operation

More options are available via the ellipsis menu.

GitKraken Desktop showing a dropdown menu with bulk workspace options, including Select All, Open repositories, and Remove repositories.
Accessing more multi-repo actions
Action Description
Clone Clone all selected repositories. HTTPS is used by default unless SSH is configured in your settings. Only available if repositories aren’t already cloned.
Fetch Fetch all selected repositories.
Pull Pull all selected repositories. Customize pull behavior from the dropdown menu.
Open in GitKraken Desktop or an external editor Open all selected repositories in GitKraken or your default editor.
Locate in filesystem Reveal local paths of selected repositories or update their location.
Remove Remove selected repositories from the Workspace.

View Pull Requests in Launchpad

Access open pull requests for all repositories in a Workspace directly from Launchpad.

GitKraken Desktop interface showing the rocket icon to open the workspace in Launchpad.
Viewing a Workspace in Launchpad
GitKraken Launchpad showing categorized pull requests with author, collaborators, repo, and branch information listed and actions like Open in GitHub, View Repo and open code suggestion available as a dropdown.
Launchpad showing team-wide pull request details

Local Workspaces

Create a Local Workspace

To create a Local Workspace:

  1. Click .
  2. Select “Local Workspace.”
  3. Name your Workspace.
  4. Browse to select one or more repositories. You can choose:
    • Individual repositories
    • A directory of repositories
    • A VS Code Workspace file (.code-workspace)
  5. (Optional) Add an icon and description.
Dialog for creating a Local Workspace in GitKraken Desktop with workspace name, color, and repository options.
Creating a Local Workspace in GitKraken Desktop

To automatically add all repositories in a selected folder, enable the Sync with local directory option.

Perform Multi-repository Actions

You can take actions across multiple repositories within a Local Workspace:

  1. Select the checkboxes next to the repositories.
  2. Use the action toolbar at the top to:
    • Fetch: Update all selected repositories.
    • Pull: Sync selected repositories with the latest changes. Use the dropdown to customize pull behavior.
    • Open: Launch selected repositories in GitKraken or your default external editor.
    • Remove: Delete selected repositories from the Workspace.

Convert a Local Workspace to a Cloud Workspace

To enable sharing and enhanced visibility:

  1. Open your Local Workspace.
  2. Click Create cloud workspace.
  3. Choose a provider and select repositories to include.
  4. (Optional) Add additional repositories from the same provider.
Context menu in GitKraken showing the option to convert a Local Workspace to a Cloud Workspace.
Converting a Local Workspace to a Cloud Workspace

Note:
Ensure the provider integration is connected under Preferences > Integrations before creating a Cloud Workspace.


Edit a Workspace

To edit a Workspace, click the ellipsis next to the Workspace name.

Dropdown menu in GitKraken showing workspace-level actions such as open, clone, locate, edit, change color, delete, and leave workspace.
Workspace actions menu

Hide a Workspace

Hide a Workspace to reduce clutter. Hidden groups (e.g., Recents, Favorites) can be shown again using the icon.

GitKraken Desktop interface showing the option to unhide a group from the workspace list via the visibility settings menu.
Unhiding a group from the Repo Management tab

Select/Unselect Repositories

Manually select repositories for targeted multi-repo actions like Fetch or Pull.

Open/Clone/Locate Repositories

Open repositories in GitKraken Desktop or your preferred editor. You can also clone or locate repositories within the file system.

GitKraken Desktop interface showing options to clone or locate selected repositories within a workspace using the context menu.
Cloning or locating repositories

Edit Workspace Details

Customize your Workspace’s name, color, description, and access permissions.

Edit Workspace modal in GitKraken Desktop with fields to update workspace name, color, description, and team sharing settings.
Editing Workspace properties

Change Workspace Color

Use color to visually organize and prioritize Workspaces. Select Change color from the three-dot menu.


Reorder Workspaces

Drag and drop Workspaces to arrange them in the desired order.

GitKraken Desktop interface showing a hand cursor dragging a workspace section to reorder its position.
Reordering Workspaces

Use Insights to Visualize Pull Request History

GitKraken Insights helps you understand how pull requests are merged into your repositories. It provides:

  • A visual history of your repository’s development
  • Insight into pull request trends and team workflows
  • Support for GitHub.com, Bitbucket.org, GitLab.com, and Azure DevOps (Hosted)
GitKraken.dev Insights dashboard for the GitLens Team, showing metrics like copy/paste vs moved code, change lead time, deployment frequency, duplicated code, number of PR reviews, cycle time, and active users over a 90-day period.
Insights metrics view in GitKraken.dev > Insights > Dashboards

To launch GitKraken Insights:

  1. Open a Cloud Workspace.
  2. Click the Insights icon in the upper-right of the Workspace header.
Insights icon highlighted in the Workspace header of GitKraken Desktop, showing how to open Insights for the selected Workspace.
Accessing GitKraken Insights from a Workspace

This will open a new browser tab showing insights for that Workspace on GitKraken.dev.

For more details, visit the GitKraken.dev Insights documentation.


Azure DevOps Requirements for Insights

To use Workspaces and Insights with Azure DevOps:

  • You must enable Third-party application access via OAuth in Azure.
  • Navigate to Organization Settings > Policies in your Azure DevOps dashboard.

Learn more from Microsoft’s official guidance: Change application connection & security policies for your organization.


Workspace Changelog

Take a trip down memory lane, and see how Workspaces have evolved over time.

Version Highlight
10.4 Insights now on gitkraken.dev
10.3 New look for Repo Management tab
10.1 Customize your Repository Management tab
10.0.2 Workspaces merge with Repository Management
10.0 Focus View becomes Launchpad
9.5 Multi-pull + Share Workspace
9.2 Issue View added (now in Launchpad)
9.1 Insights for Azure DevOps
9.0 Local & Cloud Workspaces + Insights
8.9 Team Overview added
8.8 Workspace Overview added
8.6 Bitbucket support added
8.5 Azure DevOps support added
8.4 Workspace pull requests added
8.2 Workspaces introduced
Have feedback about this article? Did we miss something? Let us know!
On this page