Getting started

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

InstallCopy Anchor Link

With Homebrew:

brew install --cask thetinygoat/tap/flowterm

Or by hand:

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

If you use Ghostty, Flow copies your Ghostty config the first time it opens, so your fonts, theme and keybindings carry over. See Configuration.

Your first workspaceCopy Anchor Link

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

To see every shortcut, click the ? button in the title bar and choose Keyboard Shortcuts.

Open a folder in FlowCopy Anchor Link

Each of these opens the folder as a new workspace in the front window:

• Run open -a Flow ~/Code/my-project in any terminal.
• Drop the folder on Flow’s icon in the Dock.
• Right-click the folder in Finder and choose Services › New Flow Workspace Here. New Flow Window Here opens it in a new window instead.

UpdatesCopy Anchor Link

When a new version is out, Flow shows its release notes and offers to install it. To check now, choose Flow › Check for Updates…. To stop the automatic checks, turn off Check for updates automatically in Settings › General.

Next stepsCopy Anchor Link

• Workspaces, tabs and panes
• Agents
• Settings
• Keyboard shortcuts