Configuration

Flow keeps its settings in a plain text file at ~/.config/flow/config. It uses Ghostty’s format, and every Ghostty option works in it. The Settings window writes to the same file, so you can use either.

If XDG_CONFIG_HOME is set, the file is $XDG_CONFIG_HOME/flow/config. To use a file somewhere else, set FLOW_CONFIG to its path.

Coming from GhosttyCopy Anchor Link

The first time Flow opens, it creates its config file and copies your Ghostty config into it, so your fonts, theme and keybindings carry over. It copies whichever of these exist:

• ~/.config/ghostty/config and ~/.config/ghostty/config.ghostty
• ~/Library/Application Support/com.mitchellh.ghostty/config and config.ghostty in the same folder

After that, Flow reads only its own file. Changes you make to your Ghostty config don’t reach Flow, and changes in Flow don’t touch Ghostty. To copy your Ghostty config again, delete ~/.config/flow/config and reopen Flow.

Flow still finds themes in ~/.config/ghostty/themes.

Edit the fileCopy Anchor Link

Open Settings › Advanced and click Open in Editor. After you save the file, choose Flow › Reload Configuration (⇧⌘,) to apply it. Flow doesn’t watch the file, so changes wait for a reload.

When you change something in Settings, Flow rewrites only that option’s line. Your comments and the lines you added by hand stay as they are. If Flow can’t read the file, Settings shows a warning and leaves the file alone.

If the file has a mistake, such as a misspelled option, Settings › Advanced lists it under Problems.

See Ghostty’s config reference for every option. If an option you rely on has no effect in Flow, open an issue.

ExampleCopy Anchor Link

font-family = JetBrains Mono
font-size = 13
theme = light:Rose Pine Dawn,dark:Rose Pine
background-opacity = 0.94
background-blur = true

Including other filesCopy Anchor Link

config-file loads another file after this one, as in Ghostty. An included file’s values win over the ones in Settings. Settings › Advanced lists each setting an included file overrides, so you know why a change in Settings has no effect.

config-file = ~/.config/flow/work