The project bar

What's on it

Project name

Opens the switcher. Same as ⌥⌘OOption 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 ⌥⌘OOption Command O

1. Press ⌥⌘OOption 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

• Switches projects: Ferrum Editor, FerrumGIT, FerrumTerm, FerrumContainers, FerrumPorts, FerrumEnv.
• Shows the project, no switcher: FerrumAPI and FerrumData. FerrumData shows the database connection in place of the path.
• FerrumKit and Ferrum Launcher have no project bar.

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"]
    }
  ]
}