Workspaces and windows
A workspace is a group of repositories with its own window, colour and Git identity. Repositories join a workspace by matching its rules, or by being pinned to it. Open a repo and it lands in the right window on its own.
Where to find it
- Title bar › workspace switcher: the coloured name at the left of the title bar lists every workspace and ends with Manage workspaces…
- Repository › Workspaces and Identities…
- Command palette › Workspaces: Switch to the name workspace, Manage workspaces and identities…
Windows
Each workspace opens in its own window. Repositories that match no workspace open in a plain window of their own. Within a window, repositories are tabs (⌘T for a new one, ⌘W to close, ⌘⇧] and ⌘⇧[ or ⌃Tab to move between them). ⌘⇧W closes the window.
A repository opened from Finder, from the mergepond command or from another window is routed to the window of the workspace it belongs to, and that window comes to the front. If the workspace has no window yet, one opens. The 2 pixel edge along the top of each window is the workspace colour.
The Workspaces sheet
The sheet opens with "Each workspace opens in its own window. Repos join the first workspace whose rule they match." Each row shows the colour swatch, the name, "(this window)" for the current one, its first rule and "and N more rules" (or "N pinned repos, no rules", or "No rules yet"), and an identity chip reading "label identity" or "No identity". Click a row to edit it.
Below is the Identities list; see Git identities. A note reads "Before each commit Mergepond checks the identity matches the workspace and warns you if it doesn't."
The footer has Done and Add workspace, and on Free a count: "N of 3 on Free".
Workspace form
| Field | Default | What it does |
|---|---|---|
| Name | Empty (placeholder "Acme") | Required. Shown in the title bar and the switcher. The form says "Give the workspace a name." if left empty. |
| Identity | None, use Git's settings | The identity repositories in this workspace commit with. See Git identities. |
| Colour | A lane colour | One of eight swatches, "Shown as the edge along the top of the window." |
| Rules | None | Which repositories belong here. See below. |
| Pinned repos | None | Repositories that belong here regardless of rules. Pin repo adds the one open in this window; click a pinned repo to unpin it. |
Buttons: Delete workspace (on an existing one), Cancel, and Save or Add workspace.
Rules
A rule is a kind and a pattern. Globs use * for one path segment and ** for any depth. The hint under the list reads "The first workspace with a matching rule wins. Globs: * and **."
| Kind | Example | Matches |
|---|---|---|
| Folder | ~/work/acme/** | The repository's path on disk. ~/ expands to your home. A pattern without a trailing glob also matches everything under it. |
| Remote URL | github.com/acme/* | The origin URL, normalised: git@github.com:acme/api.git becomes github.com/acme/api before matching. |
| SSH host | dev-box | For a remote repository, the SSH host it is on; for a local one, the host in its remote URL. user@ is stripped. |
| Repo tag | client-work | A tag you gave the repository in Repository settings. Case-insensitive. |
How a repository is assigned: a pin wins over any rule. Otherwise workspaces are tried in order and the first with a matching rule gets the repository.
Repository settings
Sidebar › gear beside the repository name (tooltip "Repository settings: identity and tags"), or Repository › Repository Settings…, opens settings for the one repository: which identity it commits with, and its tags. Tags are chips: type one and press Return or a comma to add it, Backspace to remove the last. The hint reads "Workspace rules can match repos by tag. Press Return to add one." The identity part is described on Git identities.
Free and Pro
Mergepond Free includes 3 workspaces. Adding a fourth shows a dialog headed "Mergepond Free includes 3 workspaces" with the text "Pro adds unlimited workspaces, remote repos over SSH and the worktree board. Enter your licence key in Settings, or delete a workspace to add another." and the answers Not now and Enter licence key. Existing workspaces keep working past the limit; only adding is blocked. Pro has no limit.