Settings

Every persistent setting, changeable mid-session.

Docs on GitHub

Type /settings to open a dialog with every persistent setting. Changes are written to $ZOT_HOME/config.json and take effect on the next turn — no restart needed.

SettingWhat it controls
render imagesDraw images returned by read inline using the terminal's image protocol (Ghostty, Kitty, iTerm2, WezTerm). Auto-detected from TERM_PROGRAM; the toggle overrides detection. Greyed out and forced off on terminals that speak no image protocol.
auto-swarmLet the main agent spawn background sub-agents in parallel via swarm_spawn.
thinking levelReasoning depth: off, minimum (~1k thinking tokens), low (~2k), medium (~8k), high (~16k), maximum (~32k). Also settable per run with --reasoning.
color themeauto/dark/light or any JSON theme from $ZOT_HOME/themes or a loaded extension.