October 11-13, 2022

GitKon 2022

GitKraken Client Documentation

Workspaces

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.

Overview

The overview section will provide you with a summary of Pull Requests, Issues, and WIPs relevant to you for the repos grouped in your Workspace.

  • My Pull Requests: shows all PRs opened by you, assigned to you, or awaiting your review
  • My Issues: shows all issues created by you, assigned to you, or that mention you.
  • Work in Progress: shows all branches with uncommitted changes

Instead of hunting for these pieces of information separately, you can get a holistic view of what you’re working on.

Note: This Overview section is in Preview mode, and we’d love to hear your thoughts and feedback. Just click on the “Provide feedback on this view” prompt in the upper left of the Overview page to tell us what you think.

Team Overview

On a Team workspace, you will see a Teams Workspace section. This view shows all pull requests and issues for the repositories in your Workspace – giving you a high level view of your team’s coding efforts.

You can switch the Issue Tracker provider from the My Issues section in the Overview tab.

Team Pull Requests

This section of the Team Overview will show all Pull Requests related to your selected team.

The Team Pull Requests section has the following columns:

  • Last Updated
  • PR title with link to open the pull request in the hosting provider
  • PR Author
  • Repo name with link to open the repo in GitKraken Client
  • Review status
  • PR status
    • Shows status for “Draft” or “At Risk” pull requests
  • Checks – Shows CI/CD results
  • Lines added/removed
  • PR branch
    • Double click to check out directly in GitKraken Client
  • GitHub.com Workspaces Only:
    • Shortcut to open the Pull Request Panel
    • Filter by assignee or author

Team Issues

Team Issues will show all GitHub Issues, GitLab Issues, Jira Cloud Issues, Jira Server, or Trello cards associated with the repo.

With Team Issues it is easy to switch between Jira or Trello and back to either GitHub Issues or GitLab Issues. If you select Jira or Trello, you can also filter by project so that you only see issues that matter to you.

Note: This Team Overview section is in Preview mode, and we’d love to hear your thoughts and feedback. Just click on the “Provide feedback on this view” prompt in the upper left of the Overview page to tell us what you think.

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