Customize
Terminal Behavior
Shell, cursor, scrolling, clipboard, and terminal UI behavior.
| Key | Default | Description |
|---|
shell | login shell | Executable used for new sessions. |
term | xterm-256color | TERM value exposed to child apps. |
colorterm | truecolor | COLORTERM value exposed to child apps. |
shell_integration_enabled | true | OSC 133 prompt and command tracking. |
| Key | Default | Description |
|---|
cursor_style | block | block or line. |
cursor_blink | true | Enable blinking cursor animation. |
| Key | Default | Description |
|---|
mouse_scroll_multiplier | 3 | Mouse wheel scroll speed multiplier. |
scrollbar_visibility | on_scroll | off | always | on_scroll. |
scrollbar_style | neutral | neutral | muted_theme | theme. |
scrollback_history | 2000 | Lines retained in scrollback (alias: scrollback). |
inactive_tab_scrollback | unset | Scrollback limit for inactive tabs. |
| Key | Default | Description |
|---|
pane_focus_effect | soft_spotlight | off | soft_spotlight | cinematic | minimal. |
pane_focus_strength | 0.6 | Strength of active pane emphasis (0.0 – 2.0). |
| Key | Default | Description |
|---|
copy_on_select | false | Auto-copy selected text. |
copy_on_select_toast | true | Show toast when text is copied on select. |
clipboard_read | ask | Whether programs may read the clipboard with OSC 52: ask prompts each time, allow answers silently, deny refuses. Writes are always allowed. |
Termy supports the Kitty clipboard protocol (OSC 5522) out of the box. Terminal
applications can list, read, and write multiple clipboard formats—including
images and other non-text data—and can receive MIME-aware paste events. Reads
that are not covered by a short-lived paste token or a remembered application
grant require confirmation; format listing does not expose clipboard contents
and does not prompt. The primary selection is supported on Linux. Native and
tmux terminals use the same behavior.
Full-screen terminal apps that paint their own background, such as OpenCode,
extend it into the padding around the grid when running in a single pane, so a
different terminal theme does not leave a contrasting border. Apps that leave
any edge cell on the terminal's default background, such as Claude Code and
Codex, keep your theme's padding even while a diff or dialog fills most of the
screen. Window controls and tabs remain available.
| Key | Default | Description |
|---|
command_palette_show_keybinds | true | Show shortcut badges in command palette rows. |
progress_indicator_enabled | true | Show OSC 9;4 progress bars and OSC 7501 program status badges. |
| Key | Default | Description |
|---|
tmux_enabled | false | Enable tmux runtime integration. |
tmux_persistence | true | Reuse tmux tabs and panes across restarts. |
tmux_exclusive | false | Stay in tmux control mode; restart it instead of falling back to a classic terminal when control mode exits. |
tmux_binary | tmux | tmux executable path or binary name. |
tmux_show_active_pane_border | false | Show active tmux pane border highlight. |