Settings
Every option in Flow's Settings window and what it changes.
Choose Flow › Settings… (⌘,) to open Settings. Changes apply as you make them. Flow saves most of them to your config file, so you can also edit them there by hand.
General
| Setting | What it does |
|---|---|
| Shell | The shell new terminals start. Login shell uses your account’s shell. Choose another installed shell, or Custom… to type a command such as /usr/bin/env nu. |
| Confirm closing terminals | When Flow asks before closing a pane, tab, workspace or window: Never, With a running process or Always. |
| Copy on select | Copies text to the clipboard as soon as you select it. |
| Hide mouse pointer while typing | Hides the pointer until you move the mouse. |
| Secure keyboard entry | Stops other apps from reading what you type in Flow: Off, At password prompts or Always. |
| Check for updates automatically | Lets Flow look for new versions. Check Now checks right away. |
While secure keyboard entry is on, a lock shows at the top right of the terminal. You can also turn it on from Flow › Secure Keyboard Entry.
Appearance
Colors
Pick a theme for Light mode and one for Dark mode, and Flow switches between them with macOS. Choose Same as light mode to use one theme all the time. The preview shows each theme’s colors.
The sidebar and title bar are light or dark to match the theme in use, so a dark theme gets a dark sidebar even in light mode.
The list has the themes that come with Flow and any themes in ~/.config/ghostty/themes.
Text
| Setting | What it does |
|---|---|
| Font | Any fixed-width font installed on your Mac. The default is JetBrains Mono. |
| Size | The font size, from 6 to 72. |
| Thicken text | Draws text slightly bolder. |
Cursor
| Setting | What it does |
|---|---|
| Shape | Block, Bar, Underline or Hollow block. |
| Blink | Makes the cursor blink. |
| Bar at shell prompts | Shows a blinking bar at the shell prompt, whatever the shape above. Programs you run still get the shape you picked. |
Bar at shell prompts affects terminals you open after changing it. Shape and blink change right away.
Window
| Setting | What it does |
|---|---|
| Background opacity | How much of the desktop shows through the terminal, from 20% to 100%. |
| Dim unfocused panes | How much to dim the panes you’re not typing in. |
| Background blur | Blurs the desktop behind the terminal. It needs an opacity below 100%. |
| Show scroll bar | Shows a scroll bar you can drag. |
Notifications
Agents
Flow alerts you when an agent in a terminal you can’t see needs you or finishes. See Agents.
| Setting | What it does |
|---|---|
| Agent needs input › Notification | Posts a notification when an agent is waiting for you. |
| Agent needs input › Sound | The sound to play. Ping by default. |
| Agent finished › Notification | Posts a notification when an agent’s turn ends. |
| Agent finished › Sound | The sound to play. Glass by default. |
Pick None to turn a sound off. The list includes any sounds you’ve added to ~/Library/Sounds.
Command finished
Flow can tell you when a long command finishes.
| Setting | What it does |
|---|---|
| Notify | Never, When the terminal is not visible or Always. |
| Minimum duration | Only commands that run at least this long count. |
| Notification | Posts a notification that says whether the command succeeded and how long it took. |
| Bell | Rings the terminal bell. |
Advanced
Config file shows where your config file is. Show in Finder reveals it, and Open in Editor opens it in your default text editor.
Problems lists anything wrong with the config file, such as a misspelled option. It also lists any setting that a file you include with config-file sets too, since that file’s value wins over the one in Settings. After editing the file by hand, click Reload Configuration or press ⇧⌘,.