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.
View Repository Details
You may select the icon to open the repository details.
Repository statuses
Workspaces expose the state of all repositories so you can see the last checked-out branch, how many commits are ahead or behind the remote, and your work in progress with counts of modified added, deleted, and renamed files.
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.
