Skip to content
GitTree
العربية
Stashes and worktrees

Organize workspaces

A workspace is a named set of repositories that opens as a unit, such as “Client A” or “Mobile”. Its dashboard shows every repository’s branch, sync state and changes, plus the pull requests and CI/CD runs across them.

FreeUpdated

Works in GitTree Free: every local Git feature, once you are signed in.

On this page
  1. Before you start
  2. Where to find it
  3. Steps
  4. Expected result
  5. Rename or delete
  6. If something goes wrong
  7. Questions
  8. Related

Before you start

  • A few repositories you work on together.

Where to find it

  • The workspace button at the start of the tab bar (it shows the current workspace, such as Default).
  • The command palette: Switch Workspace…, New Workspace…, Manage Workspaces….
ActionmacOSWindows and Linux
The command palette, then Switch Workspace…⌘⇧PCtrl+Shift+P

Steps

  1. Create a workspace

    Run New Workspace…, name it and press Create Workspace. It starts empty.

  2. Add repositories

    Switch to it and open repositories, or use Add Repository to Workspace…. Scanning a folder can add many at once.

  3. Read the dashboard

    Manage Workspaces… opens the dashboard: Overview lists each repository’s branch, ahead and behind counts and changes; Pull requests and CI/CD gather them across repositories.

  4. Switch

    Choose another workspace from the workspace button or Switch Workspace…. Each keeps its own set of tabs.

Expected result

Your repositories are grouped, and each group opens with its own tabs.

Rename or delete

Rename Workspace… and Delete Workspace… change only the workspace: its repositories stay on disk and in your recents.

If something goes wrong

A repository shows “not read (untrusted)”

It is in restricted mode. Open it and review its trust (repository trust).

Questions

Can one repository be in two workspaces?

Yes. A workspace only lists repositories; adding one to another workspace changes nothing on disk.

Related