Settings
Mergepond has few settings, and they live in one sheet: your licence, updates and privacy. Appearance has its own sheet, and anything about a repository or a workspace is set where it applies.
Where to find it
- Mergepond › Settings…, or ⌘,.
- The Settings button at the right of the title bar.
- Command palette › View › Settings… ("Settings and licence key…" on Free).
- The Unlicensed pill in the title bar opens it on Free.
Licence
What this section shows depends on whether a Pro licence is active on this Mac.
On Free
A badge reads "Unlicensed" and the text explains the split: "Mergepond Free includes 3 workspaces. Pro adds remote repos over SSH, unlimited workspaces and the worktree board…" Under it:
| Control | What it does |
|---|---|
| Licence key | A text area with the placeholder "MP1.…" for the key from your purchase email. |
| Activate | Checks the key with mergepond.dev once and stores it. "Activating checks the key with mergepond.dev once. After that it works offline." |
On Pro
"Mergepond Pro", then "Licensed to email. New features until date; fixes for life." and a Deactivate this Mac button, which frees the seat so you can activate another Mac.
How the licence is checked: the key is verified offline on launch; once a day, when online, Mergepond also asks mergepond.dev whether the key has been revoked. Working offline for longer changes nothing.
Updates
| Shows | Meaning |
|---|---|
| Mergepond version | The version you are running. |
| "Mergepond checks for updates when it opens." | There is no setting to turn this off. |
| Mergepond version is available | An update has been found. |
| Button | What it does |
|---|---|
| Check now | Checks for an update immediately. Also Mergepond › Check for Updates…. |
| Install and relaunch | Downloads the update, installs it and reopens Mergepond with your repositories as they were. |
When an update is waiting, an Update pill appears in the title bar. Clicking it opens a dialog: "Mergepond version is available", "You have current. Installing takes a few seconds, then Mergepond reopens with your repositories as they were.", a What's new link, and the buttons Later and Install and relaunch.
Privacy
| Setting | Default | What it does |
|---|---|---|
| Share anonymous usage analytics | Off | When on, Mergepond sends six events: app launched (with Free or Pro and the colour scheme), analytics enabled, workspace added (Free or Pro), workspace limit reached, worktree added (from a branch, a new branch or a pull request), and update installed. Each event is checked against a fixed schema before it leaves the app, so nothing else can be sent: no paths, repository names, branches or commits. |
Appearance
Colour scheme and following macOS Light and Dark are in the Appearance sheet, not here. See Colour schemes.
Settings that live elsewhere
| Setting | Where |
|---|---|
| Colour scheme, follow macOS | View › Appearance… |
| Worktree folder pattern, setup recipe, coding agents | Worktrees tab › gear, saved in .mergepond.local.toml or .mergepond.toml at the root of the repository. See Worktrees and worktree setup and Project settings files. |
| Repository identity and tags | Sidebar › repository gear. See Git identities. |
| Settings written by hand, per repository | .mergepond.toml and .mergepond.local.toml, which also name a workspace and an identity. See Project settings files. |
| Workspaces, rules, identities | Repository › Workspaces and Identities…. See Workspaces and windows. |
| Sidebar and inspector widths, worktree layout | Dragged and chosen in place; remembered for every window. |
Free and Pro
The sheet is the same on both; only the Licence section differs. Pro adds remote repos over SSH and the worktree board, and lifts the three-workspace limit.