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.
Note:
To create a Workspace, the integration for the desired service must be connected under Preferences > Integrations.
Create a workspace
To create a Workspace, navigate to the Workspaces tab. If this is your first time creating one, select . Otherwise, select .
You can give the Workspace a name, icon, description, and make it personal or shared with your organization. Under Add repositories, select which hosting service these repositories will be from. If you have not connected the integration, selecting that service will take you to the integration connection. Finally, select the desired repositories for the workspace and then .
Workspace type
Workspaces are available as either a Personal or Team type.
Personal Workspaces are only accessible by you on this machine.
Team Workspaces will be available for 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.
Learn more about how to create a team.
Edit a workspace
Edit a workspace by selecting the ellipsis icon by the Workspace name.
Multi-repository actions
All repositories in a Workspace can be cloned, fetched, or opened at once, making it easy to get a new member of your team onboarded quickly or keep repository information up-to-date. Repositories can be effortlessly opened in GitKraken, in your default editor, or on their hosting service.
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.
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.
Workspace breadcrumb in toolbar
The option to remove the Workspace breadcrumb in the toolbar can be toggled under Preferences > UI Customization > Show Workspace breadcrumb in toolbar.
View Repository Details
You may select the icon to open the repository details.
Pull requests
The Pull Request section will show all open pull requests for all repositories within the selected workspace. Information shown here includes the pull request title, pull request number, CI status, the name of the branch being merged, and number of comments.
To view a workspaces pull requests, select a workspace and then select Pull Requests.
Select Filter pull requests to filter for pull requests with the following options:
- "Opened by Me", to show pull requests that were opened by the user. This filter is available for GitHub, GitHub Enterprise, GitLab, and GitLab Self-Managed repositories.
- "At Risk", to show any pull requests that are not drafts and have been open for longer than 7 days. This filter is currently only available for GitHub, GitHub Enterprise, GitLab, and GitLab Self-Managed repositories.
- "By repository", to limit the view to a single repo within the Workspace. This filter is currently available for Azure DevOps, GitHub, GitHub Enterprise, Gitlab, and Gitlab Self-Managed repositories.
The search allows searching by pull request titles for all services. For GitHub.com workspaces, GitHub’s search syntax can also be used.
At risk pull requests are pull requests that have not been updated in more than 7 days. This is indicated by the At risk label.
GitHub pull request view
If you are working with a GitHub.com workspace, you may select a pull request to work with the GitHub pull request view.
