Skip to main content

Open your first project

A project is a directory, usually a Git repository. Saggar automatically scans your configured folders for repositories, so yours may already be waiting in the Project menu.

To open a scanned project from the command palette, press ⌘K, type the repository name, and select it. You can also choose File ▸ Open Project… or press ⌘⇧O to open a directory directly.

The project appears in the Project menu with its terminals nested beneath it. Press ⌘T to open the default terminal type, or use the menu to choose a plain shell or an installed agent.

You can also install the shell command from Settings ▸ General, then run:

saggar .

That adds or focuses the repository in the running app. It does not open a second copy of Saggar.

Next, read Projects and terminals for organization and restoration, or Set up a project workspace for monitors, Quick Runs, notes, and documentation.