Mac Settings
This page lists every setting in Rex for Mac and where to find it. Anything tagged Bleeding Edge is on that update channel and not yet in Preview.
Integrations
Coding Agents
Teach Claude Code, Codex, OpenCode and Pi how to use Rex. In Settings > Integrations > Coding Agents. agents, ai, claude, claude code, codex, opencode, pi, skill, hooks, rex skill setup, llm, assistant, integrations
| Setting | Description |
|---|---|
| Integrate with available agents | Installs a Rex skill and session hooks for supported agents. In Settings > Integrations > Coding Agents. install skill, remove skill, set up agents, uninstall, enable agents, disable agents, update skill |
Agent Behavior
Choose what Rex tells coding agents running in its terminals. In Settings > Integrations > Agent Behavior. agent instructions, agent rules, session hook
| Setting | Description |
|---|---|
| Let agents name sessions | Let agents label the session after the task they’re working on. Shown while Integrate with available agents is on. In Settings > Integrations > Agent Behavior. rename session, session label, session name, auto name, title, label sessions |
Notifications
In-App Notifications
Choose where floating notifications appear in the window. In Settings > Notifications > In-App Notifications. notifications, notification settings, alerts, banners, notification center, in app notifications, customize notifications
| Setting | Description |
|---|---|
| Notification position | Click a position in the window diagram to place notifications at the top or bottom, aligned left, center, or right. In Settings > Notifications > In-App Notifications. notification position, notification placement, banner location, anchor, top left, top center, top right, bottom left, bottom center, bottom right |
Program Activity
Independently configure tab indicators, system notifications, Dock badges, and sounds for program activity. In Settings > Notifications > Program Activity. program activity, tab activity, activity indicators
| Setting | Description |
|---|---|
| Show activity in tabs | Show working dots, progress pies, and needs-attention dots and messages on tabs when a program in them reports its status. In Settings > Notifications > Program Activity. program status, process status, osc 7501, agent, claude, progress, progress pie, blocked, waiting, question, permission, error, failed, status dot, status badges, notification dot, badge, working, tab status, indicator, needs attention |
| Include idle processes in activity | Keep tabs whose programs report that they’re idle in the Activity filter and popup, even after you’ve seen them. In Settings > Notifications > Program Activity. idle, idle processes, idle agents, ready, activity filter, activity popup, keep idle, show idle, include idle, always show idle processes in activity, eye |
| Show each process in tabs | Split a tab with more than one active pane into a row for each pane in the Activity filter and popup. Clicking a row focuses its pane. In Settings > Notifications > Program Activity. each process, each process in activity, every process, all processes, split processes, split tabs, panes, pane rows, agents, multiple agents, expand tabs, activity filter, activity popup, eye |
| Show system notifications | Send a macOS notification when a program reports a status while Rex is in the background, independently of tab indicators. Clicking it opens the program’s tab. In Settings > Notifications > Program Activity. program notifications, agent notifications, background notifications, claude notification, notify when done, notify when blocked, notifications without tab indicators |
| Badge Dock icon | Show on Rex’s Dock icon how many tabs have a program that’s blocked, failed, or finished that you haven’t seen. In Settings > Notifications > Program Activity. dock badge, badge count, app icon badge, unread count, red badge, badge application icon, dock icon |
| Play sounds | Play a sound when a program in a tab is blocked, reports an error, or finishes. In Settings > Notifications > Program Activity. sound, audio, chime, alert sound, beep, bell, audible, monoh, sound effects, program finished, done sound, mute, silence |
| Working | Enable or disable all activity for working programs, or configure their tab indicators, notifications, Dock badges, and sounds individually. In Settings > Notifications > Program Activity. working status, busy, progress, spinner, running, disable all working, enable working status |
| Blocked | Enable or disable all activity for programs waiting for you, or configure their tab indicators, notifications, Dock badges, and sounds individually. In Settings > Notifications > Program Activity. blocked status, waiting, question, permission, approval, sign in, attention sound, blocked notifications, disable all blocked, enable blocked status |
| Error | Enable or disable all activity for programs reporting errors, or configure their tab indicators, notifications, Dock badges, and sounds individually. In Settings > Notifications > Program Activity. error status, failed, failure, error sound, disable all errors, enable error status |
| Done | Enable or disable all activity for finished programs, or configure their tab indicators, notifications, Dock badges, and sounds individually. In Settings > Notifications > Program Activity. done status, finished, complete, completed, success sound, finish sound, disable all done, enable done status |
System Notifications
Choose whether terminal programs can send native macOS notifications, and see the ones Rex sends for Tailscale. In Settings > Notifications > System Notifications. native notifications, macOS notifications, mac notifications, tailscale alerts, terminal notifications
| Setting | Description |
|---|---|
| Terminal notifications | Let programs send native notifications with OSC 9 or OSC 777. In Settings > Notifications > System Notifications. osc 9, osc 777, osc9, osc777, desktop notification, notify-send, escape sequence, program notifications, printf notify |
| Tailscale sign-in | A native notification when Rex needs you to sign in to Tailscale. In Settings > Notifications > System Notifications. tailscale login notification, sign in, authentication, account |
| Tailscale device approval | A native notification when a tailnet administrator must approve this Mac. In Settings > Notifications > System Notifications. device approval notification, approve mac, tailnet administrator, authorization |
| Tailscale failures | A native notification when Tailscale stops or reports an error. In Settings > Notifications > System Notifications. tailscale failure notification, tailscale stopped, connection error, offline |
Server
Rex Server
Manage the local server, compatibility, and diagnostics. In Settings > Server > Rex Server. start, stop, restart, status, version, api, diagnostics
| Setting | Description |
|---|---|
| Server status | See whether the local server is running and for how long, with version and API details in its info popover. In Settings > Server > Rex Server. health, running, stopped, preparing server, failed, error, source checkout, server details, server version, api revision, uptime, running time, how long, started, duration |
| Compatibility | When an update, compatibility issue, or pending settings change is detected, see the discrepancy and update or restart the server when appropriate. In Settings > Server > Rex Server. incompatible server, restart recommended, update rex app, restart server, upgrade server, newer server, available version, restart required, new features, apply settings, use bundled server, older app, backward compatible, a newer server is available, updating is optional, optional update, new API features are available, newer API features, unavailable features, server settings have changed, cannot connect to this server, this server requires a newer rex app, server and app are incompatible, reconnect, server compatibility, pending changes, update server, restart using included server, restart from source |
Remote Address
Check serving progress, copy the address, or pair another device. In Settings > Server > Remote Address. tailnet, https, endpoint, connectivity
| Setting | Description |
|---|---|
| Remote Address | Check serving progress and certificate readiness, retry, copy the address, or pair a device using its QR code. In Settings > Server > Remote Address. copy remote address, tailscale connection progress, https, dns, hostname, endpoint, copy, qr, scan, pair, device, iphone, ipad, certificate, waiting for certificate, tls, ssl, secure, starting, stopping, connection progress, retry, connected, disconnected, approval, error, dns recovery |
Tailscale
Connect Rex to your tailnet and control who can access it. In Settings > Server > Tailscale. network, vpn, remote, secure, sharing
| Setting | Description |
|---|---|
| Serve over Tailscale | Enable or disable access to Rex over your tailnet. In Settings > Server > Tailscale. connect, network, vpn, share, enable, disable |
| Preferred Hostname | Choose this Mac’s Tailscale hostname while serving. The assigned address may differ. In Settings > Server > Tailscale. hostname, device name, dns, rename, machine, address, assigned address, host id, durable host id, identity |
| Limit access to your Tailscale account | Restrict callers to your account or allow tailnet members. In Settings > Server > Tailscale. security, authentication, identity, permissions, owner, members, acl |
| Tags | See this device’s Tailscale tags. Sign out and back in to change them. In Settings > Server > Tailscale. tag, tagged, acl tags, advertise tags, tailnet policy, machine identity, owner, access |
| Control Server | See which control server this device signs in with. Sign out and back in to change it. In Settings > Server > Tailscale. control url, control plane, coordination server, login server, self-hosted, custom server |
| Sign in to Tailscale | Check your account and sign-out progress, configure a hostname and sign in, reopen or cancel enrollment, or sign out. In Settings > Server > Tailscale. login, tailscale login, sign in, sign in to tailscale, log in, sign out, account, status, signed in to tailscale, enrolled account, signing in to tailscale, browser sign in, open browser, reopen browser, preparing to sign in, this may take a moment, ready to connect, awaiting connection, finish the process in your browser, taking longer than usual, slow sign in, cancel sign in, cancel login, signing out of tailscale, remove saved login, sign out progress |
Client Info
Choose how this Mac appears to Rex servers and the command line. In Settings > Server > Client Info. client, device, identity, rex client ls, command line, cli
| Setting | Description |
|---|---|
| Label | Name this Mac in client lists and for targeting it from rex commands. In Settings > Server > Client Info. device label, client label, name, computer, identify, rename, rename this mac, this device, -C, target, targeting, client ls |
| Remote Control | Let Rex and other clients perform actions in this app. In Settings > Server > Client Info. remote, control, allow, allow actions, actions, command line, rex do, perform, security |
Interface
Appearance
Choose the color scheme, interface materials, and theme tint. In Settings > Interface > Appearance. look, visual, display, theme
| Setting | Description |
|---|---|
| Color scheme | Select a live Auto, Light, or Dark material preview. Auto follows the system appearance. In Settings > Interface > Appearance. colour, light, dark, auto, automatic, system, night mode, cards |
| Interface style | Preview Glass or Classic materials with the current theme tint and select a surface style. In Settings > Interface > Appearance. glass, classic, liquid glass, material, native, system, modern, opaque, translucent, cards |
| Tint with theme | Apply the selected theme’s colors to interface surfaces. In Settings > Interface > Appearance. tint, theme colors, theme colours, palette, themed, blended, blend theme, use theme |
| Use glass for panes | Available with the Glass interface style: add glass to panes alongside window and tab materials. In Settings > Interface > Appearance. pane glass, no glass, remove glass, liquid glass, pane material, transparency |
Tabs
Choose tab placement, sizing, and pane icon counts and colors. In Settings > Interface > Tabs. workspace, chrome, layout, navigation, tab bar, icons, symbols, pane cards, icon stack, tab icons
| Setting | Description |
|---|---|
| Tab style | Place tabs Above, on the Left Side, or on the Right Side of the window. In Settings > Interface > Tabs. vertical, horizontal, sidebar, navigation, orientation, sidebar position, above, left side, right side, left sidebar, right sidebar, edge, location |
| Fill available space | Available with horizontal tabs: expand tabs equally to fill the bar, showing backgrounds only for two or more tabs. In Settings > Interface > Tabs. tab width, stretch, expand, full width, equal width, maximum, capped |
| Use color for tab icons | Show colored icons Always, For active panes, For active tabs, or Never. In Settings > Interface > Tabs. colour, monochrome, grayscale, greyscale, saturation, always, never, active panes, active tabs, focused pane, selected tab |
| Shell icon theme | Choose Default artwork, Use theme for background and foreground colors, or Use theme accent for accents. In Settings > Interface > Tabs. shell colors, shell colours, terminal icon, shell palette, default, use theme, use theme accent, accent, background, foreground, glyph |
| Show tab icons | Show zero to three pane icons in vertical tabs, or up to five in horizontal tabs. In Settings > Interface > Tabs. icon count, icons per tab, number of icons, stack size, stack limit, icon count slider, slider, maximum, none, hide icons, no icons, zero icons, one icon, two icons, three icons, four icons, five icons, 0, 1, 2, 3, 4, 5, pane icons |
Window
Available with sidebar tab styles: choose whether the sidebar resizes the window, and which swipe shows or hides it. In Settings > Interface > Window. window sizing, window width, sidebar, layout, swipe, trackpad
| Setting | Description |
|---|---|
| Preserve width when resizing sidebar | Available with vertical tabs: resize panes when showing or hiding the sidebar, keeping the window width unchanged. In Settings > Interface > Window. keep window width, preserve window width, fixed window width, resizing sidebar, window size, resize window, shrink window, grow window, keep window size, show sidebar, hide sidebar, toggle sidebar, collapse sidebar, fold sidebar, pane width, maximized, full screen |
| Use a gesture to toggle the sidebar | Available with vertical tabs: choose whether a swipe or an Option-swipe shows or hides the sidebar, or turn the gesture off. Hold the ⌥ key to scroll content sideways instead. In Settings > Interface > Window. show or hide sidebar, option-swipe, option swipe, ⌥, off, disable swipe, turn off swipe, no gesture, disable gesture, magic mouse, mouse, one finger, option scroll, alt scroll, option key, alt key, hold option, modifier, swipe, two finger swipe, two fingers, trackpad, gesture, trackpad gesture, sidebar swipe, swipe sidebar, fold sidebar, horizontal scroll, scroll sideways, sideways, side scroll, scroll left, scroll right, tui, diff, long lines |
Panes
Adjust pane spacing, headers, and program backgrounds. In Settings > Interface > Panes. workspace, chrome, layout, density, spacing, split
| Setting | Description |
|---|---|
| Pane style | Choose Comfortable or Compact pane surfaces and spacing. In Settings > Interface > Panes. compact, comfortable, pane density, padding, gaps, spacing |
| Show pane headers | Show the title and controls above each pane. In Settings > Interface > Panes. titles, toolbar, chrome, hide headers |
| Match program backgrounds | Color a pane and its header with the background a full-screen program paints. In Settings > Interface > Panes. tint, pane color, header color, pane background, terminal background, program background, editor, full screen, tui, neovim, vim, extend, padding color, blend, match terminal |
Pane Padding
Set the space between a pane’s edges and its terminal text, and the color drawn there. Opens from Customize pane behavior under Panes. In Settings > Interface > Pane Padding. pane padding, terminal padding, inset, margin, margins, gutter, spacing around text, edges, window padding
| Setting | Description |
|---|---|
| Padding X | Set the space to the left and right of the terminal text. In Settings > Interface > Pane Padding. horizontal padding, x padding, left padding, right padding, side padding, horizontal inset, horizontal margin |
| Padding Y | Set the space below the terminal text, and above it when pane headers are hidden. In Settings > Interface > Pane Padding. vertical padding, y padding, bottom padding, top padding, vertical inset, vertical margin |
| Padding color | Use the pane background or extend edge-cell backgrounds into the padding. In Settings > Interface > Pane Padding. colour, extend, extend always, background, edge cells |
Active Pane
Highlight the edges of the active pane and fade inactive ones. Opens from Customize pane behavior under Panes. In Settings > Interface > Active Pane. customize pane behavior, pane behavior, active pane, active panes, inactive panes, focused pane, unfocused panes, pane focus, focus appearance, dim inactive
| Setting | Description |
|---|---|
| Highlight active pane edges | Highlight the edges of the focused pane, following focus. In Settings > Interface > Active Pane. border, outline, focus ring, active border, focused pane, highlight, highlight active pane, edge highlight, indicator, focus indicator, show border on active pane |
| Highlight color | Draw the highlight in the accent, a terminal palette color, or the terminal text color. In Settings > Interface > Active Pane. accent, accent color, theme color, terminal text, terminal foreground, foreground color, text color, highlight color, border color, focus ring color, active pane border color, swatch, color swatches, palette, red, blue, green, yellow, cyan, magenta |
| Highlight opacity | Set how strongly the highlight draws. In Settings > Interface > Active Pane. opacity, transparency, alpha, translucent, faint, subtle, strength, border opacity, border strength, focus ring opacity, highlight strength, active pane border opacity |
| Animate active pane highlight | Fade the highlight to the newly focused pane, move it there, or switch it at once. In Settings > Interface > Active Pane. fade, move, crossfade, glide, slide, animate, animation, transition, border motion, focus animation, highlight animation, border fade, border move, off, instant, no animation, active pane border animation |
| Fade inactive panes | Fade unfocused pane surfaces, content, both, or neither. In Settings > Interface > Active Pane. dim, opacity, unfocused, focus, inactive, off, none, surface, surface only, content, content only, surface & content, surface and content, both, neither, decorations, styling, text, background, borders, shadows, glass, fade inactive pane content |
| Fade panes for inactive windows | Fade inactive windows while respecting the pane fade choice. Glass content fades equally in every pane. In Settings > Interface > Active Pane. window inactive, window focus, background window, switch apps, window deactivation, standard window styles, theme defaults, all panes, fade panes in inactive windows, use pane fade choice, fade content for inactive windows, liquid glass content |
Splits & Focus
Balance a tab’s splits and let focus follow the pointer. Opens from Customize pane behavior under Panes. In Settings > Interface > Splits & Focus. splits, split panes, split balancing, pointer focus, pane layout
| Setting | Description |
|---|---|
| Autobalance splits | Evenly resize a tab’s panes whenever a pane is created or closed. In Settings > Interface > Splits & Focus. balance panes, equalize, even, equal size, new pane, close pane, split, resize |
| Focus follows mouse | Focus a pane by moving the pointer over it, without clicking. In Settings > Interface > Splits & Focus. hover, pointer, cursor, sloppy focus, mouse focus, active pane, select pane, without clicking |
Gestures
Turn trackpad gestures for panes and the sidebar on or off. In Settings > Interface > Gestures. gestures, trackpad, multi-touch, fingers
| Setting | Description |
|---|---|
| Use trackpad gestures | Spread two fingers over a pane to zoom it and pinch them to restore it, and swipe to show or hide the sidebar. In Settings > Interface > Gestures. use gestures, pinch, pinch to zoom, pinch zoom, magnify, magnification, spread, pinch zoom pane, unzoom, trackpad zoom, trackpad pinch, two finger pinch, swipe, sidebar swipe, disable gestures, turn off gestures, no gestures, trackpad gestures |
Animation
Choose how panes move, open, and close. In Settings > Interface > Animation. motion, animations, transitions, movement
| Setting | Description |
|---|---|
| Animation style | Choose Snappy, Natural, or Off for pane motion, the active border, and showing or hiding the sidebar. Off while Reduce Motion is on. In Settings > Interface > Animation. snappy, natural, off, spring, bounce, no bounce, overshoot, disable animations, turn off animations, reduce motion, instant, fast, speed, pane animation, split animation, hyprland, sidebar animation |
App Icon
Customize Rex’s app icon and Dock and menu bar icon visibility. In Settings > Interface > App Icon. app icon, application icon, dock icon, artwork, beta icon
| Setting | Description |
|---|---|
| App Icon | Choose Default — Dynamic, Bright, or Twilight artwork for the app icon. In Settings > Interface > App Icon. app icon, application icon, dock icon, custom icon, alternate icon, bright, bright icon, twilight, twilight icon, light icon, dark icon, beta, artwork, dynamic, dynamic icon |
| Show app icon | Show Rex’s icon in the Dock and menu bar, the Dock only, or the menu bar only while no window is open. In Settings > Interface > App Icon. dock and menu bar, dock only, menubar only, menu bar only, dock icon, hide dock icon, show dock icon, dock visibility, application switcher, app switcher, command tab, cmd tab, menubar, menu bar icon, status item, status bar, tray icon, hide menu bar icon, show menu bar icon, hide, show, visibility |
Launch
Choose whether Rex opens workspace windows at startup. In Settings > Interface > Launch. launch, startup, start up, opening, background
| Setting | Description |
|---|---|
| Show window on launch | Automatically open workspace windows when Rex launches. In Settings > Interface > Launch. show window on launch, open window on startup, launch in background, hide window on launch, restore windows, start minimized |
Themes
Light Mode
Select the theme palette used in light appearance. In Settings > Themes > Light Mode. colors, colours, appearance, theme, palette, day, bright
| Setting | Description |
|---|---|
| Light theme | Choose a custom, default, or built-in palette used in light mode. In Settings > Themes > Light Mode. day, bright, light colors, colour scheme, new light theme, edit light theme, customize light theme, duplicate light theme, fork light theme, delete light theme, theme customizer, ansi palette, ansi standard, ansi bright, terminal colors, preview, live preview, live update, pause preview, freeze, theme editor |
| Use extended theme palette | Use the theme’s colors 16–255 in light mode, or xterm’s standard palette when off. In Settings > Themes > Light Mode. extended palette, extended colors, extended colours, xterm, xterm palette, standard palette, color cube, colour cube, grayscale ramp, greyscale ramp, generated palette, palette-generate, compatibility, on, off |
Dark Mode
Select the theme palette used in dark appearance. In Settings > Themes > Dark Mode. colors, colours, appearance, theme, palette, night, dim
| Setting | Description |
|---|---|
| Dark theme | Choose a custom, default, or built-in palette used in dark mode. In Settings > Themes > Dark Mode. night, dim, dark colors, colour scheme, new dark theme, edit dark theme, customize dark theme, duplicate dark theme, fork dark theme, delete dark theme, theme customizer, ansi palette, ansi standard, ansi bright, terminal colors, preview, live preview, live update, pause preview, freeze, theme editor |
| Use extended theme palette | Use the theme’s colors 16–255 in dark mode, or xterm’s standard palette when off. In Settings > Themes > Dark Mode. extended palette, extended colors, extended colours, xterm, xterm palette, standard palette, color cube, colour cube, grayscale ramp, greyscale ramp, generated palette, palette-generate, compatibility, on, off |
Import Theme
Add a Ghostty or iTerm palette to your custom themes. In Settings > Themes > Import Theme. import, file, ghostty, iterm, itermcolors, palette, load, colors, colours, appearance, background, light, dark
Terminal
Typography
Preview and choose the terminal font, size, style, and weight. In Settings > Terminal > Typography. text, typeface, readability, typography preview, font preview
| Setting | Description |
|---|---|
| Terminal font | Browse monospaced or all installed fonts to choose the terminal typeface. In Settings > Terminal > Typography. font, family, typeface, monospace, menlo, font picker, monospaced fonts, all fonts |
| Font size | Adjust terminal text size in points. In Settings > Terminal > Typography. text size, larger, smaller, zoom, pt |
| Font style | Choose an installed face of the terminal font, such as Light or Book. In Settings > Terminal > Typography. face, variant, italic, oblique, regular, light, medium, semibold, book |
| Font weight | Adjust the stroke weight of a variable terminal font. In Settings > Terminal > Typography. thickness, thin, light, medium, bold, heavy, variable font, wght |
Advanced Font Settings
Adjust character spacing, line height, ligatures, smoothing, and fallback fonts. Opens from Advanced under Typography. In Settings > Terminal > Advanced Font Settings. advanced font settings, advanced typography, advanced font options, advanced fonts, font rendering, text rendering, font options
| Setting | Description |
|---|---|
| Character spacing | Tighten or widen terminal character spacing in pixels or percent. In Settings > Terminal > Advanced Font Settings. letter spacing, kerning, tracking, cell width, adjust-cell-width, ghostty, maple mono, tighter, wider, pixels, percentage |
| Line height | Add or remove space between terminal lines. In Settings > Terminal > Advanced Font Settings. cell height, line spacing, leading, adjust-cell-height, ghostty, spacing, taller, compact |
| Ligatures | Join characters like -> and != into single symbols. In Settings > Terminal > Advanced Font Settings. font features, font-feature, calt, liga, arrows, operators, fira code, jetbrains mono |
| Bold and italic | Draw bold and italic always, only when the font has them, or turn either off. In Settings > Terminal > Advanced Font Settings. font-synthetic-style, font-style-bold, font-style-italic, synthetic style, pseudo bold, fake bold, faux bold, fake italic, faux italic, oblique, slant, slanted, outline, emboldened, pixel font, bitmap font, disable bold, no bold, never bold, disable italic, no italic, never italic, upright, bold face, italic face, font weight, regular, always, if the font has them, bold only, italic only, neither, bold, italic, ghostty |
| Font smoothing | Smooth the edges of terminal text. In Settings > Terminal > Advanced Font Settings. antialiasing, anti aliasing, text rendering, sharp, font-thicken, thicken |
| Fallback fonts | Choose fonts, in order, for characters the terminal font doesn’t have. In Settings > Terminal > Advanced Font Settings. fallback, font fallback, font-family, missing glyphs, missing characters, symbols, icons, nerd font, cjk, chinese, japanese, korean, emoji, font order, ghostty |
Colors
Control terminal text colors and readability. In Settings > Terminal > Colors. colour, color, text, readability
| Setting | Description |
|---|---|
| Improve text contrast | Adjust low-contrast text against its background; included when using the theme palette. In Settings > Terminal > Colors. minimum contrast, automatic, legibility, accessibility, unreadable, faint, pale, yellow, ansi, truecolor, theme, on, off |
| Force theme palette for text | Map RGB and extended text colors to the nearest theme color, then correct contrast. In Settings > Terminal > Colors. force theme colors, force theme colours, remap, match colors, palette, ansi, rgb, truecolor, 256 colors, extended colors, replace, consistent, on, off |
| Use Display P3 color space | Read theme and program colors as Display P3, like Ghostty’s window-colorspace. In Settings > Terminal > Colors. p3, display p3, wide gamut, wide colour, color space, colour space, colorspace, window-colorspace, ghostty, srgb, saturated, vivid, on, off |
Cursor
Preview and adjust the terminal cursor shape and blinking. In Settings > Terminal > Cursor. caret, insertion, indicator, cursor preview
| Setting | Description |
|---|---|
| Blink speed | Choose Off, Slow, Normal, Fast, or Custom to edit the blink interval. In Settings > Terminal > Cursor. flashing, steady, slow, fast, normal, off, custom |
| Blink interval | Set the time between cursor blinks in milliseconds when Blink speed is Custom. In Settings > Terminal > Cursor. speed, duration, frequency, ms, custom |
| Cursor style | Choose a block, bar, or underline cursor. In Settings > Terminal > Cursor. shape, beam, caret, block, bar, underline |
| Force style | Ignore application requests to change cursor shape. In Settings > Terminal > Cursor. override, application, ignore, shape |
Keyboard
Show key sequence hints and choose how modifier keys behave in terminal input. In Settings > Terminal > Keyboard. input, keys, shortcuts, modifier
| Setting | Description |
|---|---|
| Show key sequence hints | Show the keys that can come next after the first key of a sequence, such as a tmux-style prefix. In Settings > Terminal > Keyboard. which-key, which key, prefix, leader, chord, key sequence, popup, overlay, pill |
| Option key | Choose whether the Option key sends Alt or types special characters. In Settings > Terminal > Keyboard. option, alt, meta, esc, escape, emacs, readline, tmux, compose, accents, special characters, left, right, ∫ |
Scrolling
Choose how trackpad and Magic Mouse scrolling move through terminal history. In Settings > Terminal > Scrolling. scroll, scrollback, history, trackpad, touchpad
| Setting | Description |
|---|---|
| Smooth scrolling | Move through terminal history by pixels instead of whole lines. In Settings > Terminal > Scrolling. smooth, pixel, precise, sub-line, fluid, momentum, inertia, trackpad, line by line, on, off |
Resizing
Choose how terminal text follows a pane as it changes size. In Settings > Terminal > Resizing. resize, window size, pane size
| Setting | Description |
|---|---|
| Smooth terminal resizing | Reflow terminal text on the frame a pane changes size, without waiting for the server. In Settings > Terminal > Resizing. smooth resize, resize, reflow, jitter, glitch, jump, flicker, live resize, resize preview, zoom, split, sidebar, window drag, drag, re-wrap, rewrap, on, off |
Selection
Preview selection colors and corners, and customize copying with its animation. In Settings > Terminal > Selection. highlight, selected text, copy, colour, animation, selection preview
| Setting | Description |
|---|---|
| Copy on selection | Automatically copy selected terminal text to the clipboard. In Settings > Terminal > Selection. automatic copy, clipboard, selection, mouse, on, off |
| Play animation on copy | Shine across the selection to confirm each copy. In Settings > Terminal > Selection. shine, highlight, sheen, glint, pulse, effect, feedback, motion, animate, on, off |
| Selection foreground | Choose the text color inside a selection. In Settings > Terminal > Selection. foreground, text color, colour, contrast |
| Selection background | Choose the fill color behind selected text. In Settings > Terminal > Selection. background, highlight color, colour, fill |
| Rounded corners | Round the corners of terminal text selections. In Settings > Terminal > Selection. radius, rounding, square |
Links
Choose whether terminal links that launch other apps ask first. In Settings > Terminal > Links. hyperlink, url, osc 8, command click, cmd click, open link, security, safety, custom scheme, url scheme
| Setting | Description |
|---|---|
| Links that open apps | Ask before, always, or never open links such as ssh:// that launch another app. In Settings > Terminal > Links. ask first, ask before opening, always open, never open, confirm, confirmation, prompt, allow, block, vscode, ssh, custom scheme, launch app, open app |
| Trusted links | Review and remove the links you chose to always open, once Always Open adds one. In Settings > Terminal > Links. always open, allowed links, allowlist, trusted apps, remembered, forget, remove, revoke, permissions |
Integrated Path Browser
Choose what Insert Path lists when it types a path at the cursor. In Settings > Terminal > Integrated Path Browser. insert path, path browser, file picker, path picker, paths, files, folders, autocomplete, completion
| Setting | Description |
|---|---|
| Show recently used paths | List the paths you chose most recently first, shared by every session on a host. In Settings > Terminal > Integrated Path Browser. recents, recent files, history, recently used, mru, frequent, remember, on, off |
Titles
Choose how terminal tabs and pane headers are named. In Settings > Terminal > Titles. tab, window, pane, name, label
| Setting | Description |
|---|---|
| Prefer generated titles | Show the running program and its directory instead of titles that shells set. In Settings > Terminal > Titles. shell title, generated title, program name, process name, directory, working directory, path, ignore shell titles, always use generated titles, automatic, on, off |
Shell
Choose the command run when a new local terminal opens. In Settings > Terminal > Shell. startup, session, command line, login
| Setting | Description |
|---|---|
| Startup command | Set the executable and arguments, or leave empty for the default login shell. In Settings > Terminal > Shell. shell, zsh, bash, fish, executable, arguments, launch, startup, working directory |
Remote Hosts
Remote hosts
Add, reorder, and manage remote Rex hosts, view connection status, and retry connection failures. In Settings > Remote Hosts > Remote hosts. remote, connections, machines, servers, add host, remove host, retry, host details, remote host status, remote host reconnect, connection warning, connection failure, host address, reorder hosts, host order, sort hosts, arrange hosts, move host up, move host down, drag hosts
Developer
Reveal settings for development and debugging. In Settings > Developer. advanced, debug, tools
| Setting | Description |
|---|---|
| Developer Mode | Show update-channel, installation, local API, web-client origin, and experiment settings. In Settings > Developer. enable, advanced, development, debugging |
Experimental
Try features that aren’t finished when Developer Mode is enabled. In Settings > Developer > Experimental. experiment, beta, unfinished, labs
| Setting | Description |
|---|---|
| Download new updates when available | Download updates in the background and ask before restarting. In Settings > Developer > Experimental. Needs Developer Mode. auto download, background download, install on quit, download new updates, auto update, sparkle |
| Install updates automatically | Relaunch into the new version while Rex is not visible. In Settings > Developer > Experimental. Needs Developer Mode. auto install, auto relaunch, auto restart, silent update, unattended update, relaunch when idle |
| Cursor shaders | Draw a trail shader, such as Warp, Comet, or Blaze, behind terminal cursors. In Settings > Developer > Experimental. Needs Developer Mode. cursor trail, cursor effect, cursor animation, smear, glow, warp, sweep, comet, blaze, tapered, rainbow, gradient, frozen, ghostty shader, custom-shader, shadertoy |
| Group Activity by priority | Offer Group by priority in the Activity filter menu, listing each process by its state. In Settings > Developer > Experimental. Needs Developer Mode. activity, group by, priority, sort, blocked, failed, done, working, idle, processes, filter |
App Version
Choose how Rex.app receives updates when Developer Mode is enabled. In Settings > Developer > App Version. application, release, update, channel, upgrade
| Setting | Description |
|---|---|
| Update Channel | Choose Preview or Bleeding Edge updates when Developer Mode is enabled. In Settings > Developer > App Version. Needs Developer Mode. bleeding edge, testing, snapshot, preview, version, upgrade |
Rex Installation
Choose the included server or run Rex from a source checkout. In Settings > Developer > Rex Installation. binary, install, source, development
| Setting | Description |
|---|---|
| Location | Use the server included with Rex.app or a local source checkout. In Settings > Developer > Rex Installation. Needs Developer Mode. bundled, included, source checkout, installation |
| Source Directory | Choose the folder containing the Rex source checkout. In Settings > Developer > Rex Installation. Needs Developer Mode. folder, path, repository, repo, checkout, choose |
| Installation status | Check whether the selected Rex installation is ready to run. In Settings > Developer > Rex Installation. Needs Developer Mode. show details, hide details, version, binary, executable, copy, paths, status |
| Version | View and copy the included server version under Show Details. In Settings > Developer > Rex Installation. Needs Developer Mode. release, build, included, bundled, copy |
| Commit | View and copy the source commit of the included server under Show Details. In Settings > Developer > Rex Installation. Needs Developer Mode. revision, git, hash, build, copy |
| Final SHA-256 | View and copy the included server checksum under Show Details. In Settings > Developer > Rex Installation. Needs Developer Mode. checksum, digest, hash, sha256, integrity, copy |
Local API
Inspect the local server’s API endpoint when Developer Mode is enabled. In Settings > Developer > Local API. local server, control api, development, connection
| Setting | Description |
|---|---|
| Local API URL | View and copy the local server endpoint when Developer Mode is enabled. In Settings > Developer > Local API. Needs Developer Mode. address, localhost, port, http, copy local endpoint, unix socket, socket path |
Web Client Origins
Manage browser origins allowed to open Rex WebSocket streams. In Settings > Developer > Web Client Origins. browser, web, websocket, security, cors
| Setting | Description |
|---|---|
| Allowed origins | Review the permitted origins and remove custom entries. In Settings > Developer > Web Client Origins. Needs Developer Mode. allowlist, delete, remove, hosted client, default, permissions |
| Origin pattern | Enter a browser origin or wildcard subdomain to allow after restarting Rex. In Settings > Developer > Web Client Origins. Needs Developer Mode. add origin, allowed origin, wildcard, subdomain, domain, https, web client |