Skip to main content

Appearance

The Appearance tab controls how TermFlow looks — terminal font size, how the tab strip behaves when it runs out of room, and the color palette your terminals render with (globally and per coding agent).

Open it from Settings → Appearance (Ctrl/Cmd + ,). Changes apply live to every open terminal and to new tabs, and are persisted to your config file.

Where this lives

Settings has four tabs: Appearance, Terminal Behavior, Shell Profiles, and Connections. This page covers only the first.

Options at a glance​

OptionWhat it controlsDefaultRange / values
Font Size (px)Text size in every terminal pane148–32 (effective)
When tabs overflow the title barHow the tab strip reacts when tabs no longer fitFixed width, scrollshrink · scroll · fixed
Tab width (px)Fixed width for each tab (only when the mode above is fixed)15060–300, step 10
Color SchemaThe terminal ANSI color palette applied globallyDefault24 built-in schemes
Agent Color SchemesPer-agent palette overrides (codex, claude, …)noneany built-in scheme, per agent

The Appearance panel​

┌────────────────────────────────────────────────────────────────┐
│ Settings                                            [ ✕ ]       │
├──────────────┬─────────────────────────────────────────────────┤
│ Appearance ◀ │  Appearance                                      │
│ Terminal     │                                                  │
│ Shell Prof.  │  Font Size (px)          [ 14        ]           │
│ Connections  │                                                  │
│              │  When tabs overflow…     [ Fixed width, scroll ▾]│
│              │  Tab width (px)          [ 150       ]           │
│              │                                                  │
│              │  Color Schema                                    │
│              │   ┌──────┐┌──────┐┌──────┐┌──────┐               │
│              │   │Defaul││Dracul││ Nord ││Gruvb.│  … (24)       │
│              │   └──────┘└──────┘└──────┘└──────┘               │
│              │                                                  │
│              │  Agent Color Schemes                             │
│              │   codex   [ Dracula ▾ ]  [×]                     │
│              │   claude  [ Nord    ▾ ]  [×]                     │
│              └─────────────────────────────────────────────────┘

Font Size​

Sets the point size of the terminal font across all panes and tabs.

  • Default: 14
  • Effective range: 8–32

An honest note: the number field lets you type values up to 72, but TermFlow clamps the saved value to the 8–32 range. Anything above 32 is stored as 32; anything below 8 becomes 8. Treat 8–32 as the real limit.

This is a separate control from per-pane zoom. Zooming a single pane with Ctrl/Cmd + =/-/0 (or Ctrl/Cmd + wheel) changes only that pane and never touches this global font size — see Zoom. The Settings window itself also keeps its own persisted zoom level, independent of the terminal font size.

Font family is not on this screen

The typeface (fontFamily, default Consolas, "Courier New", monospace) is a config-file-only value with no UI control. See Advanced config file if you need to change it.

Tab overflow behavior​

The dropdown labelled "When tabs overflow the title bar" decides what the tab strip does once you have more tabs than fit across the window. Three modes:

ValueUI labelBehavior
shrinkShrink tabs to fit (show all)Compresses every tab so they all stay visible in the title bar, however narrow they get.
scrollKeep tab width, scroll (wheel + arrows)Keeps tabs at a readable width and scrolls the strip — mouse wheel or the ‹ › arrow buttons — to reach off-screen tabs.
fixedFixed width, scroll (wheel + arrows)Default. Gives every tab the same configurable width (see Tab width below) and scrolls the same way once tabs overflow.

Tab width​

Only visible when the overflow mode is Fixed width, scroll. Sets the identical width, in pixels, of every tab.

  • Default: 150
  • Range: 60–300 (the input steps in increments of 10)

Values outside 60–300 are clamped to the nearest bound.

Color Schema​

A grid of 24 built-in color schemes — each card previews the scheme's 16 ANSI swatches and its name. Click one to apply it. The selection takes effect immediately on every open terminal and on all new tabs.

  • Default: Default

The catalog spans dark, light, and mid-toned palettes, including well-known names such as Windows Terminal (Campbell), Dracula, Nord, Solarized Dark / Solarized Light, One Dark, Gruvbox Dark, Monokai, Tokyo Night / Tokyo Night Day, Rosé Pine / Rosé Pine Dawn, Night Owl, Material Dark, Argonaut, GitHub, plus originals like Sunset and a nostalgic Turbo Pascal.

Light schemes are handled properly

The light palettes (Solarized Light, Tomorrow, GitHub, Tokyo Night Day, Rosé Pine Dawn) ship with tuned selection-highlight colors, so selected text stays visible on their pale backgrounds.

Agent Color Schemes​

TermFlow can give a pane its own palette based on which coding agent is running in it. When a mapped agent (for example codex, claude, or agy) is detected in a pane, that pane adopts the agent's assigned scheme, overriding the global Color Schema above. This makes it easy to tell at a glance which pane is driving which agent.

You assign an agent scheme in one of two places:

  1. Right-click a pane running an agent → "Color scheme for '<agent>'".
  2. This Agent Color Schemes list, once at least one agent has a mapping — each row shows the agent name, a scheme dropdown, and a × to remove the override.

When no overrides exist yet, the section shows a hint pointing you to the pane right-click flow. Assignments are global and persisted.

An honest note: the override is "sticky by last writer." A pane stays themed while an agent is API-driven, but if you start typing into it yourself the pane reverts toward its tab/global scheme. The full detection and priority rules — including the AgentChip pill that names the running agent — are covered in Agent color schemes.

Next steps​