Settings
Use Settings to customize Terminay's terminal behavior, AI and MCP permissions, recordings, remote access, appearance, command shortcuts, themes, accessibility, and updates. Settings is organized by where each setting is saved: on this device, or on a server.

Places
A narrow rail down the left edge lists the places settings are saved. The first tile is this device: This Mac on macOS, This PC on Windows and Linux, and This device in a browser. Below a divider there is one tile per attached server, then a Connect a server tile.
- This device holds what you see on this device, whichever server is connected: font, theme, cursor, shortcuts, accessibility, the sidebar defaults, the dictation microphone, the saved servers, and, on Desktop, Import & Export, Updates, and Diagnostics.
- A server holds what every device connected to it shares: shell profiles, tab indicators, scrollback, AI and Terminay MCP, Pixel, recording, remote access, macros, workflows, extensions, and that server's Updates page.
Each place shows only the categories that have settings saved there, and each page carries a scope line such as On this Mac · whichever server is connected or On build-box · every device connected to it. A category that mixes both kinds, such as Interaction or AI, appears under both places with only that place's fields.
Plain Settings reopens on the place you left. Opening it at a category, such as Macros or Remote Access, picks the place that has it, starting with the server that owns the active project.
Finding Settings
Within a place, categories are grouped in the sidebar. Use search to filter matching categories, sections, fields, descriptions, setting keys, and keywords in the selected place. Choosing a category clears the search and jumps to that category.
Changes save automatically as you edit. The footer shows Saving..., Loading..., or Saved. Reset to defaults restores the selected place only, after confirming: resetting a server leaves this device alone, and resetting this device never contacts a server.
Categories
Categories are grouped in the sidebar. Categories that hold a list, such as Servers, Macros, Workflows, and Extensions, add a list column between the sidebar and the detail.
- General: Appearance (font, size, weight, line height, glyph rendering, transparency, the status bar), Theme (colours, Tab Theme Hue, ANSI palette), Shortcuts, Accessibility (minimum contrast, screen reader mode), Files (refresh interval, ignored folders, the Changes view, sidebar panes), and AI (agent status, AI tab titles and notes, the Git push agent, Terminay MCP and its permissions, connected MCP servers, Pixel, dictation).
- Terminal: Shell (shell profiles, the default working directory, close-on-success, Keep terminals running after quit, and Move terminals into new worktree folders), Cursor, Interaction, and Scrolling.
- Connections: Servers and Import & Export under this device, and each server's Remote Access.
- Automation: Macros, Workflows, and Recording.
- Extensions: the extensions installed on the selected server, including the bundled agents, TypeScript, Gitea, and GitHub extensions, and installing new ones.
- System: Updates under every place, and Diagnostics under this device.
Search also matches the items inside list categories: server names, macro names and script text, and extension names. Recordings live in Home, and Bots are configured in their own Home tabs.
Live Preview
Appearance, cursor, and theme changes show a live terminal preview. The preview updates immediately, can be resized, and can be hidden or shown again.
Theme Colors
Theme color fields can use a fixed custom color, and supported cursor and selection fields can use Tab Theme Hue. Tab Theme Hue resolves the terminal color from the active terminal tab or project color, so each tab can carry its own cursor and selection accent.
Terminay uses Tab Theme Hue for the default cursor and selection highlight, while falling back to readable static colors when a terminal has no tab color available.
When a color uses Tab Theme Hue, a brightness slider (0–100%) sets how light or dark that hue renders, so you can derive anything from a subtle dark background to a vivid accent from the same tab color. Out of the box, the terminal background is a dark tint of the tab hue, so tabs of different colors carry subtly different backgrounds.
AI Tab Metadata
Open AI to choose whether Command Bar actions can generate terminal tab titles or notes. Each target can be disabled or configured independently with Codex or Claude Code, then assigned a provider-specific model.
Codex models are discovered through the Codex CLI. Claude Code exposes a small built-in model list because its CLI does not currently provide model discovery.
AI generation uses recent terminal output as bounded context. If the selected provider cannot load models or generate text, Terminay leaves the existing title or note unchanged.
Shell Profiles
New terminals start from a shell profile owned by the connected server. System default follows that server account's shell. Custom profiles can choose an executable or WSL distribution, keep each argument separate, add environment variables, and carry an optional name, icon, and color.
Open Shell → Shell Profiles to pick the server default and the default working-directory policy. Projects and individual terminals can override the server default. Discovered shells can be used once or copied into a custom profile. Changing a profile only affects terminals created afterward.
Environment values are visible only in the profile editor. They are never included in workspace, session, recording, diagnostic, or remote summary data.
Enable Close tabs on successful exit to automatically close a terminal tab when its shell exits with code 0.
Tab Indicators
Terminals without a recognized agent show activity from their output. Under Appearance → Tab Indicators, Use terminal signals for activity reads OSC 9;4 progress, OSC 133/633 command markers, OSC 9/777 notifications, and the terminal bell before falling back to recent output. Signals never override agent status, and escape sequences still reach the terminal unchanged.
Progress signal timeout (default 15 seconds) sets how long a progress signal without an update can keep a tab marked busy.
Terminay MCP Permissions
Under a server's AI → Terminay MCP, Enable Terminay MCP server turns agent terminal control on or off. Below it, Read Terminals, Full Terminal Management, Read Automations, and Full Automation Management can each be set to Ask Permission, Always Allow, or Never Allow. See Terminay MCP for what each group covers and how approval prompts work.
Terminal Interaction
Programs can copy to the clipboard, under this device's Interaction, lets a program in a terminal put text on this device's clipboard with the OSC 52 escape sequence. It works for programs on a remote server too, such as an editor or tmux over SSH. It is on by default. Programs can never read the clipboard, and output replayed on reconnect or from a recording never writes it.
Convert LF to CRLF, under the server's Interaction, is off by default. Turn it on only for output that sends bare line feeds and expects each to start a new line.
Status Bar Host Stats
Under this device's Appearance → Status Bar, Show host stats adds small live graphs of CPU, memory, network, and disk I/O to the status bar. They describe the machine that runs the active tab's server: the remote host for a remote server, this computer for the Local server. It is off by default. Host stats interval sets the seconds between samples, from 1 to 3600 (default 5). The server samples its host only while a device shows the graphs.
Remote Access Settings
A server's Remote Access page covers that server's exposure only. Turn on Automatically expose server on startup to expose it each time Terminay starts, without choosing Expose this server from the connections menu. It is off by default. You can still stop exposure from the connections menu for the current session, and new devices still need approval.
The same page lists devices waiting for approval, trusted devices, and live connections, and offers Reset server identity…. WebRTC hosted domain and WebRTC ICE servers configure signaling and STUN/TURN for remote connections. Most setups can leave them at their defaults. See Remote Access for pairing.
The servers this device connects to are under this device's Servers, with Add server…. The Connect a server tile on the rail opens the same form.
Pull Requests And Issues
Under a server's Extensions, the GitHub and Gitea extensions each list the forge Accounts they found or you signed in with, and a Repositories choice: Everything I can access, Repositories of open projects, or Chosen owners. Switches turn Pull Requests on Home, Issues on Home, and the Project Git tab on or off. See Pull Requests & Issues.
Updates
Every place has an Updates page showing two exact versions: Running, and Latest on its track, or Up to date, Not checked yet, or why a check failed.
- This device (Desktop only) sets the Update channel for Terminay Desktop and the Local server built into it: Stable follows tagged releases, Nightly is built once a night from
main, and Canary is built on every push tomainand is the least tested. It never changes any other server. Install latest on the channel installs that channel's current build, even an older one, after a confirmation that names both versions. - A server shows its release track, Check for updates, Upgrade when a newer release is out, and Install latest on its track. Change track lists the command to run on the server's host to move it to another track. The Local server follows Terminay Desktop, so its page links to this device's Updates instead.
See Installation for how updates are downloaded and applied.
Import & Export

Import & Export, under this device on Desktop, copies macros, workflow templates, custom shell profiles, automations, and portable settings categories between servers. Open it from Settings, from Import & Export… in the application menu, or from the Command Bar.
It shows a matrix with one row per item and one column per attached server. Each cell says whether that server's copy is same, differs, or missing. Filter by kind or text, or turn on Only differences.
Pick a source column, tick the target columns and the rows to copy, then choose Review. Where a target already has a different item of the same name, choose Replace, Keep both, or Skip (settings offer Replace or Skip). Apply writes each item and reports how each one went. A copy is one-time: nothing links it to its source afterward. Automations always arrive disabled, and a macro or shell profile they need is copied with them.
Export selected… writes the selected rows to a JSON bundle file. Import file… adds a bundle as an extra, read-only source column, so you can copy from it the same way. A bundle never holds secrets, but item content such as macro scripts is plain text.
Shortcut Settings
Open this device's Shortcuts to customize app command key bindings. Click Listen and press a key combination. Press Esc while listening to cancel. Use Clear to disable a shortcut, Reset to restore one shortcut, or Reset All to restore every default.
Terminay normalizes shortcut names and shows platform labels. If two commands use the same shortcut, Settings shows a conflict warning.