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 ▸ Add project… or press ⌘⇧O to open a directory directly.

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

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

saggar .

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

Next, open your first agent session. For project organization and restoration, read Projects and sessions. Set up a project workspace covers monitors, quick runs, notes, and documentation.