Opening a repository

File ▸ Open Repository… (⌘O) shows a file picker. Choose the repository’s folder and Innesta opens it in the current window.

Ways in

• The picker, from the menu or from the welcome screen.
• Drag and drop — a folder onto the window, or onto the Innesta icon in the Dock.
• From a subfolder. You can point Innesta at any folder inside the repository and it walks up to find the Git root itself. Choosing Sources/Kettle when you meant Kettle opens the repository, not an error.
• From the terminal, with the innesta command line tool.
• On a launch argument, which is what the command line tool uses.

One repository per window

Each window holds one repository. File ▸ New Window (⌘N) opens another, and File ▸ New Tab (⌘T) puts it in a tab of the same window, the way any Mac application does.

Opening a repository that is already open brings its existing window forward rather than opening a second one.

Repositories outside your home folder

macOS asks for permission the first time an application reads a folder outside the places it is allowed by default. Innesta keeps that permission as a security-scoped bookmark, so an external disk or a folder in someone else’s home directory is asked about once, not every launch.

When a folder goes away

A repository you have opened stays in the Projects list as a reference, not as a promise the folder still exists. If it is deleted or moved, the entry stays and is marked Unavailable: you can still copy its path or remove it from the list, and opening it and revealing it in Finder are switched off.

If the folder of the repository you have open disappears, or stops being a Git repository, Innesta closes the session, stops everything watching it, and returns to the Projects view rather than showing you a window describing something that is no longer there.