Settings
Configure your shell, scrollback, updates, and other preferences.
Opening Settings
Section titled “Opening Settings”Press ⌘ Cmd + , to open the Settings panel. The command palette (⌘ Cmd + K) also surfaces it under “Settings”.
General
Section titled “General”Default: /bin/zsh. Enter any shell path (e.g., /bin/bash, /usr/local/bin/fish).
Scrollback Lines
Section titled “Scrollback Lines”- Range: 500 to 100,000 lines
- Default: 10,000 lines
Alert Sound
Section titled “Alert Sound”Enable an audible alert that plays when a command finishes.
Suppress Active Tab Notifications
Section titled “Suppress Active Tab Notifications”When enabled (the default), agent events on the currently visible tab do not create notification bell entries or play alert sounds.
Disable this to record every agent event in the bell regardless of which tab is active.
Auto-Updates
Section titled “Auto-Updates”When enabled, Vertical Tabs checks for updates in the background. If a new version is available, a banner appears with a button to download and install it.
Disable this to update manually.
Check for Updates
Section titled “Check for Updates”Click this button to manually check whether a newer version is available, regardless of the auto-update setting.
Tab Sort Order
Section titled “Tab Sort Order”Choose how your tabs are organized:
- Creation Order - tabs stay in the order you opened them
- Most Recent - the most recently used tab moves to the top of the list
Confirm Dangerous Actions
Section titled “Confirm Dangerous Actions”When enabled, a confirmation dialog appears before removing workspaces, closing tabs, and rolling back files.
Show Scripts in Command Palette
Section titled “Show Scripts in Command Palette”When enabled, the command palette includes scripts from your project’s package.json as runnable items. Disabled by default.
Memory Usage in Topbar
Section titled “Memory Usage in Topbar”When enabled (the default), a live memory usage indicator appears in the terminal top bar. This is also toggleable from the top bar menu.
Agents
Section titled “Agents”Default Agent
Section titled “Default Agent”Choose which agent is pre-selected when opening the launcher.
Per-Agent Models
Section titled “Per-Agent Models”Set a preferred model for each agent individually. Once configured, that model is automatically selected whenever you use that agent.
The About tab shows:
- Your current Vertical Tabs version
- The agents that Vertical Tabs works with
Account
Section titled “Account”The Account tab lets you sign in with your Tintage account. Click Sign in with Tintage to start the device-code flow, then enter the 6-digit code on the account page that opens in your browser.
When signed in, this tab shows your account profile, a link to manage your account, and a sign-out action.