Settings

Configure Supaterm from the app or the sp CLI.

Open Supaterm > Settings to configure the app.

Sections

General — app appearance, layout restoration, and zmx session persistence.
Terminal — Ghostty themes, font, font size, and close confirmation.
Notifications — macOS delivery and the glowing pane attention ring.
Coding Agents — agent integrations, status icons, spinner, and panel visibility.
Advanced — verbose diagnostics in local OSLog.
About — version, update channel, automatic updates, analytics, and crash reporting.

Stable is the production release channel. Tip checks more frequently for newer development builds. Choose the channel under About.

Supaterm stores application settings in ~/.config/supaterm/settings.toml by default. Inspect the active path and values with:

sp config path
sp config list
sp config list --changed

Read, change, or reset a setting:

sp config get appearance.mode
sp config set appearance.mode system
sp config reset appearance.mode

Validate the file after editing it directly:

sp config validate

Run sp config list for the current keys and accepted values. The CLI validates names and values before writing.