Getting started

Flow is a macOS terminal built on libghostty, the core of Ghostty. It needs macOS 14 or later.

Install

1. Download the latest .dmg from GitHub releases.
2. Open it and drag Flow into Applications.
3. Open Flow.

Your first workspace

Flow opens with one workspace in your home folder. cd into a project and the workspace takes the folder’s name.

Shortcut	Action
⌘N	New workspace
⌘T	New tab
⌘D	Split right
⌘1–9	Switch workspace

Hold ⌘ to see the shortcut for each workspace.

To open a folder as a workspace from the command line, run:

open -a Flow ~/Code/my-project

Updates

Flow updates itself. To check now, choose Flow › Check for Updates….

Next steps

• Workspaces, tabs and panes
• Keyboard shortcuts
• Configuration