The project bar: project name, path, Git branch, and buttons that open the project in another app.

What's on it

Project name
Opens the switcher. Same as Option Command O.
Path
Click a segment to reveal that folder in Finder. Right-click copies the path.
Branch
The Git branch of the project, when it's in a repository.
Editor, Git, Term
Open the same folder in Ferrum Editor, FerrumGIT or FerrumTerm.

Switch projects with Option Command O

  1. Press Option Command O or click the project name.
  2. Type to filter the recent projects by path. Use Up Arrow and Down Arrow to move, Return to open.
  3. No match? Type a folder path (~/ works) and press Return to open it, or choose Open Folder….

Each row has a button to remove it from the recent projects. Opening a folder that no longer exists shows a message instead.

Which apps have it

The recent projects file

Every app reads and writes the same list, ~/.ferrum/projects.json, newest first, up to 50 projects. Each entry has the folder's path, when it was last opened and which apps opened it:

{
  "projects": [
    {
      "path": "/Users/you/Projects/ferrum",
      "opened_at": 1793145600,
      "apps": ["ferrumeditor", "ferrumgit"]
    }
  ]
}

The file only lists folders. Nothing in it leaves your Mac; deleting it just empties the recent list.

Install Ferrum Launcher

One free download for Apple Silicon Macs. The launcher installs and updates every app.