Skip to content

Themes and appearance

Terminal app themes, rendering speed, the minimal footer and the terminal tab title.

This page covers the theme, the redraw rate, the footer mode and the tab title of the terminal app. The desktop app and the UI kit have their own themes: desktop appearance, UI kit theming.

Themes#

Settings › UI › Theme switches the theme right away. Enter cycles through the themes. The setup wizard also offers the theme. The default is default.

ThemeId
Defaultdefault
Lightlight
Catppuccin Mochacatppuccin-mocha
Catppuccin Macchiatocatppuccin-macchiato
Catppuccin Frappécatppuccin-frappe
Catppuccin Latte (light)catppuccin-latte
Gruvbox Darkgruvbox-dark
Gruvbox Lightgruvbox-light
Crush (Pantera)crush
Vaporwavevaporwave

Light, Catppuccin Latte and Gruvbox Light suit light terminals. The other themes are dark. zidane does not detect the background color of your terminal.

Extensions add themes with registerTheme (extensions). Their themes show after the built-in ones. If an extension theme uses the id of a built-in theme, the built-in theme wins. The frames on these pages show the Default theme mapped onto this site's light or dark palette.

Rendering#

SettingDoes
Settings › UI › Renderer FPSHow often the screen redraws, in frames per second. 30 saves power, 60 is the default, and 120 suits fast displays.
Settings › UI › UI modeFull (the default) shows every shortcut in the footer. Minimal shows only the agent (with more than one profile), the model and settings. It also hides the resting hints above the prompt. CtrlY lists every shortcut.

Look and feel and Footer rows with defaults: Settings. Footer chips: the chat screen.

Terminal tab title#

When Terminal title is not Off, zidane saves the tab title it found. It restores that title when you quit or set Terminal title back to Off. Some terminals cannot save a title, for example the VS Code terminal. There, zidane clears the title instead. zidane writes no title when the output is not a terminal.

Settings › UI › Terminal titleShows
Off (default)Your terminal's own title
zidanezidane
Session titleThe session title, or zidane when no session is open
Icon + sessionAn icon, then the session title

Icon + session shows three more rows. An empty row uses the default icon:

RowDefaultShows when
Session icon⚽No run is busy and nothing waits for you
Attention icon⚠️An approval, a question or a plan waits for you. You can see it from another tab.
Active icon⚡A run is busy