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.
Access Workspaces
Workspaces are listed in the Repo Management Tab. To access the Repo Management tab, either click on the folder icon located at the top left or utilize the keyboard shortcut Alt + O (Windows/Linux) or Cmd + O (Mac).
Cloud Workspaces
Cloud Workspaces will be available for you to work with on any machine and the selected teams within your organization. This helps ensure that everyone is up-to-date on the same set of repositories by offering multi-repository actions and the ability to work with all pull requests from these repositories.
Create a Cloud Workspace
To create a Cloud Workspace, select .
Then, select “Cloud Workspace”, name your Workspace, selecting the hosting service, and then select repositories to add. Optionally, you can also provide an icon, description and select teams or individual users to share with.
Note:
The integration for the desired service must be connected under Preferences > Integrations to create a Cloud Workspace.
Cloud multi-repository actions
Actions can be performed on multiple repositories within the Workspace at once, making it easy to get a new member of your team onboarded quickly or keep repository information up-to-date. To perform an action on multiple repositories, select the check box next to the repository name and then select the desired action from the options at the top.
The following multi-repository actions can be performed:
- Clone: clone all selected repositories. HTTPS will be used by default unless you have SSH configured in your Integration settings. This option is only available if the repositories are not already cloned locally. If one or more repositories are already cloned, you have to select the repositories that are not cloned and then select the clone option.
- Fetch: fetch all selected repositories.
- Pull: pull all selected repositories. You can change the behavior of the pull button by selecting the dropdown and selecting the radio button next to the desired option.
- Open in GitKraken Desktop or an external editor: open all selected repositories in GitKraken or in your default editor.
- Locate in filesystem: point to all selected repositories locally or update the local location of the repositories if they have changed.
- Remove: remove all selected repositories from the Workspace.
Pull requests
You can see all open pull requests for all repositories in Launchpad within the selected Workspace. Information shown here includes the pull request title, pull request number, CI status, complexity, the name of the branch being merged, and number of comments.
Create a Local Workspace
To create a Local Workspace, select . Then, select “Local Workspace”, name your Workspace, and browse to select repositories to add to your Local Workspace. You may select individual repositories, a directory of repositories, or a VS Code Workspace (.code-workspace). Optionally, you can also provide an icon and description.
The option “Sync with local directory” will allow you to sync the Workspace with a local directory. This will automatically add any repositories in the selected directory to the Workspace.
Local multi-repository actions
Actions can be performed on multiple repositories within the Workspace at once. To perform an action on multiple repositories, select the check box next to the repository name and then select the desired action from the options at the top.
The following multi-repository actions can be performed:
- Fetch: fetch all selected repositories.
- Pull: pull all selected repositories. You can change the behavior of the pull button by selecting the dropdown and selecting the radio button next to the desired option.
- Open in GitKraken Desktop or an external editor: open all selected repositories in GitKraken or in your default editor.
- Remove: remove all selected repositories from the Workspace.
Create a Cloud Workspace from a Local Workspace
You can create a Cloud Workspace from a Local Workspace which will enable more visibility into your pull requests, issues, and share your Workspace with teams.
To do this, select your local Workspace to open it and then select Create cloud workspace
. From here, you will need to select the provider for your new Cloud Workspace, select the repositories you would like added, and you can even add more repositories to this Workspace from the selected provider.
Note:
The integration for the desired service must be connected under Preferences > Integrations to create a Cloud Workspace.
Edit a Workspace
Edit a Workspace by selecting the ellipsis icon by the Workspace name.
The available options are:
Hide
You can hide a workspace to declutter your view, just as you can hide other groups in the Repo Management Tab (e.g., Recent Repositories or Favorites).
To show a hidden workspace or group, simply click the icon to unhide.
Select/Unselect
You can select or unselect repositories within a workspace. This functionality allows you to perform specific actions, such as fetching, pulling, or opening repositories in VS Code, on the selected repositories only.
Open/Clone/Locate Repositories
Use this option to open, clone, or locate repositories. You can apply these actions to the selected repositories or to all repositories within the workspace.
Edit Workspace
Customize your workspace by editing its name, color in the Repo Management Tab, description, and the list of members with access to the workspace. This helps you keep your workspace organized and accessible to the right team members.
Change Color
Similar to what you can do with Edit Workspace, change the color of your Workspace (or group) by selecting Change color
in the three-dot menu of any repo group. Use color to categorize Workspaces or highlight your most used groups of repositories.
Requirement for Azure Workspaces and Insights
In order to work with Workspaces and Insights for Azure, Third-party application access via OAuth
will need to be enabled in Azure from Organization Settings > Policies
. You can find more information on this setting here.