Projects
A project in Mooring is a folder on your Mac, listed under a root or added on its own.
A project in Mooring is a folder on your Mac. Its tabs, its Up Next and its file viewer all belong to that one folder.
Roots and standalone projects
The sidebar lists projects in two ways:
- Under a root. A root is a folder of projects. Each folder inside it
shows as its own project. Point a root at
~/Development, for example, and every repository in it appears in the sidebar. Manage roots in Settings ▸ General ▸ Roots, where you can add, reorder and remove roots. - Standalone. A single folder added from anywhere on your Mac. Standalone projects show under Other in the sidebar.
Add a project
Click + at the top of the sidebar, or open the File menu, then choose one of these:
- New Project… (
⇧⌘N) opens a sheet with two choices:- Empty creates a new folder with a name and an optional description.
With Git repository on, as it is at first, Mooring also makes a
repository with a first commit on the First branch,
mainunless you change it. - Clone from Git copies a repository from its URL. Mooring uses the
login your git already has, such as the macOS Keychain,
gh auth loginor your SSH key.
- Empty creates a new folder with a name and an optional description.
With Git repository on, as it is at first, Mooring also makes a
repository with a first commit on the First branch,
- Add Existing Folder… adds any folder as a project. A folder outside your roots shows under Other.
- Add Root Folder… adds a new root.
Change a project's details
Right-click a project and choose Get Info… to change:
- Ticket code, the letters at the start of each card's ticket key, such
as
SKVinSKV-42. - Description, shown when you point at the project in the sidebar.
- Terminal theme, the terminal colours for this project's tabs.
Remove a project
Removing a project or root only takes it off Mooring's list. The folder and everything in it stay on your Mac.
- A standalone project: right-click it and choose Remove from Mooring…. Mooring asks first, because removing it also closes the project's running terminal sessions.
- A root: right-click the root's heading and choose Remove Root…, or remove it in Settings ▸ General ▸ Roots. Add the same root again later and its projects come back as before.
A worktree belongs to its project
A git worktree is part of its project, not a separate project. Each worktree shows under its project in the sidebar. Click a worktree to see the tabs running in it. Click the project itself to go back to the main folder. See Worktrees and Tabs and sessions.