Settings

Click the gear icon (⚙) in the header to open the settings sidebar.

Available Settings

Setting	Description	Default
Always on Top	Keep the window above other windows	On
Opacity	Adjust window transparency (50%–100%)	100%
Font Size	Adjust the UI font size (10–20px)	13px
Theme	Switch between Dark and Light	Dark
Choice Key	Modifier for quick choice shortcuts (Ctrl or Cmd)	Ctrl
Send Key	Key combination to send input (Cmd+Enter or Enter)	Cmd+Enter
Vim Mode	Enable Escape+i sequence before sending input (for vim-mode CLI)	Off
Preview Key	Key for pane content preview (Ctrl+<key>)	P
Detail Key	Key for session detail popup (Ctrl+<key>)	D
Git Key	Key for git operations popup (Ctrl+<key>)	G
Diff Key	Key for git diff viewer (Ctrl+<key>)	F
Shell Key	Key for shell mode toggle (Ctrl+<key>)	B
Stop Key	Key to send interrupt to pane (Ctrl+<key>)	S
Compact Key	Key to toggle compact mode (Ctrl+<key>)	M
Focus Key	Global shortcut to focus unitmux (Cmd+Shift+<key>)	H

Send Key

Choose between two send behaviors:

• Cmd+Enter (default) — Enter inserts a newline, Cmd+Enter sends. Good for multi-line input.
• Enter — Enter sends immediately, Cmd+Enter inserts a newline. Faster for short commands.

Vim Mode

When enabled, unitmux sends Escape followed by i before delivering your input. This ensures the AI CLI is in insert mode if you are using vim-style key bindings in your terminal.

Changing Key Bindings

Click the current key binding button (e.g., Ctrl+P) to enter key capture mode. Press any letter key to set the new binding. Press Escape to cancel.

All settings are saved automatically and survive app restarts.