Skip to content

Settings ​

Settings go in config.toml. Every key is optional, and an unknown key is an error.

KeyMeaningDefault
appearanceWhether the window is light or dark. system follows the desktop; light and dark hold it there.system
terminal-appearanceWhether the window's terminals are light or dark. interface follows appearance; light and dark hold the terminals in that version of the theme while the window keeps its own. isc tui doesn't read it.interface
themeA theme name, or one for light and one for dark: { light = "fjord", dark = "fjord" }. A name can be a built-in theme (see Themes), a file in themes, ghostty, or ghostty:Name.fjord, dark or light as the appearance is
font-familyThe terminal font.JetBrainsMono Nerd Font
interface-fontFont for tabs, sidebar, headers and panelsInter
interface-styleinsensical: greys around the terminals, with the theme's accent and state colours. terminal: the theme's colours (From the terminal theme in the settings). isc tui is terminal unless this is set.insensical
background-opacityHow much of the desktop each pane hides, 0.2 to 1. At 1 a pane is the theme's background, solid. Settings > Interface > Panes.1
interface-opacityHow much of the desktop the sidebar hides, 0.2 to 1. The space around the panes is never thinner than its words can be read on. A light sidebar is never thinner than 0.88. Settings > Interface > Window.0.9; 1 with background-blur = false
background-blurWhether the desktop is asked to blur what shows through the window, as strongly as it blurs. It's one request for the whole window.true
at-loginWhat insensical does when you log in. off: nothing. window: opens the window. background: starts in the tray (the menu bar on a Mac) with no window, or opens the window if your Linux desktop shows no tray.off
motionWhether sheets, notices and moved panes fade in, the working mark turns and cursors blink. system follows the desktop.system
font-ligaturesWhether symbols side by side are drawn as the font's ligature, such as -> and !=true
font-sizeTerminal text size in points, 6 to 72.12; on macOS 13
densitycomfortable: each pane is a rounded card with space around it. compact: panes sit edge to edge with a hairline between.comfortable
pane-gapSpace between panes in pixels, 0 to 4012, or 0 when density is compact
sidebar-treeTree view: what each project holds, joined by tree lines. false lists a project's tabs flat, with no lines and no panes.true
sidebarThe levels the tree lists under a project's name: ["tabs", "panes"], ["tabs"] or ["panes"]. An empty list is a problem, and both are used.["tabs", "panes"]
activity-idleWhether agents at rest are listed when the sidebar shows only activitytrue
tabsWhere tabs show. sidebar: down the side, for every project. top: along the top, for the current project.sidebar
pane-headerfull: what the pane is and does, plus arrange buttons. name: the same without buttons. hidden: no header; a floating pane keeps its name.full
keymapdirect: each command has its own chord. leader: each command is a key pressed after the leader, leaving the chords to the programs.direct
leaderThe key pressed before a command's key when keymap is leaderctrl-space
shellWhat a pane runs when you give it no command, with arguments: "fish", "/bin/zsh -l".the login shell, $SHELL
input-methodWhether your system's input method may compose text in a pane, as for Bangla, Chinese or Japanese.false
option-as-altOn a Mac, whether Option with a key is Alt to the program, as in a shell's Alt+B and Alt+F, instead of typing the layout's character.false
type-aheadWhether what you type in a pane on another machine is drawn at once, a little fainter, before its program shows it. auto: when the round trip takes 70 milliseconds or more. on: over any link to another machine. off: never. See Other machines, over ssh.auto
open-files-withWhat a file you Ctrl+click opens in: system, an editor by name (code, cursor, zed, subl, idea, nvim, vim, hx, nano), or a command with {file} in it. See Web addresses and paths.system
termThe TERM a pane's program is told. xterm-ghostty gives programs every feature. xterm-256color is known on every machine, which matters over ssh, and has fewer.xterm-ghostty
scrollbackHistory each pane keeps, in megabytes, 1 to 200.10
keep-scrollbackWhether what panes show is saved when the daemon stops. With false, nothing is saved and earlier files are removed as panes close.true
check-for-updatesWhether the daemon asks GitHub once a day for a new release. With false, it asks only when you press Check Now or update yourself. See A new version installed underneath.true
keep-awakeOn a Mac, whether insensical keeps the Mac from sleeping while it runs, so your devices can reach it through a hub or over ssh. The display still sleeps, the screen still locks, and closing the lid still sleeps the Mac. A change applies within two seconds. Activity Monitor's Energy tab and pmset -g assertions show it as isc. If macOS refuses, the daemon says so in its log and runs anyway. On Linux it does nothing.true
agents-at-onceHow many agents one agent can have open at once, started with isc agent start, 1 to 64 (Agents).8
agents-deepHow deep agents can start agents, 1 to 8.2
agents-from-other-machinesWhether an agent on another machine, running isc --host or isc tui --host in a pane there, can use this computer. Off, it's refused and told how to turn this on. You at your own terminal are never refused (Agents).false
tmux-shimWhether tmux in a pane is answered by insensical, so an agent that opens helpers in tmux panes opens them as panes here (Agents). While on, tmux in a pane isn't the real one.false
clipboardWhether a program can put text on the clipboard. focused: only the program in the pane you're looking at. never: no program. No program can read the clipboard.focused
notificationsWhether you're told when a pane has something for you.true
attention-glowWhether a waiting pane takes the waiting colour at its edge and casts a soft light into the gaps around ittrue
notify-waitingWhether you're told when a pane waits for you, or a program asks for you.true
notify-failedWhether you're told when a command or agent ends badly.true
notify-doneWhether you're told when a long command or an agent's turn ends well.true
notify-commandA program and arguments the daemon runs to tell you. See When nobody is attached.none
notify-command-whenWhen the command runs. away: only with no window, terminal or browser attached. always: every time.away
notify-urlAn http or https address the daemon posts to, to tell younone
notify-url-whenWhen it's posted to: away or always, as for the commandaway
notify-url-bodyWhat's posted. json: the title, the message and the rest. text: the message alone, with the title in a Title header.json
notify-url-tokenA token sent as Authorization: Bearer … with what's posted. A secret, shown masked.none
notify-url-user, notify-url-passwordA user and password sent as Basic. The token wins if both are set. Secrets.none
notify-url-headersA table of headers sent with what's posted, for a token. Shown masked; set it with isc config set.none
long-commandSeconds a command runs before its end is news: the pane is marked done or failed, and you're told if you weren't looking. 1 to 3600.30
soundWhich notifications make a sound. needs-you: a pane that waits or failed. all: those, and a softer sound for a finish. off: none.needs-you
trayOn Linux, whether insensical has a tray icon, marked while a pane needs you, with a menu of those panes.true
menu-barOn a Mac, whether insensical has a menu bar item that counts and lists the panes that need you.true
dock-badgeOn a Mac, whether the number of panes that need you is on the Dock icon.true
[tui]What isc tui does differently from the window, which never reads this table: appearance, theme (terminal is the terminal's own colours), activity-idle, interface-style, motion, attention-glow, type-ahead, clipboard, keymap and leader, each overriding the top-level one, plus colours (auto, truecolor, 256, 16) and mousecolours = "auto", mouse = true
[keys]Keys and the command each one runs, or none, in either keymapempty
[modes]Modes of your own, and the resize mode: a table for each, with a title, a timeout and the keys that work in it. See Changing keys.resize
[icons]A program's name and its tile: a program that has one, a mark, or { mark = "docker", colour = "#ff8800" }. See Icons for your own programs.empty
[commands]Commands of your own: a name and a list of steps. See Changing keys.empty
[keys.direct]The direct keymap, written out. It lies over the defaults: your lines win, a default you don't mention stays, and none takes a default key away.the keys in the table above
[keys.leader]The leader keymap, written out. Each key is the one you press after the leader. It lies over the defaults like [keys.direct].the keys in the table above
[hosts]Other machines by name and where ssh goes for each: build = "me@build.example.com". Also { ssh = "…", icon = "…", careful = true }: an icon (server, laptop, desktop, mini, nas, board, container, cloud), and a mark for one to be careful on. isc host add writes these, and node = "…" for a tailnet machine. See Other machines, over ssh.empty

The file isc config prints sets theme to { light = "fjord", dark = "fjord" }, shows shell and interface-font as lines to uncomment, and writes out [keys], [keys.direct] and [keys.leader] with their defaults.

For the theme file format, see A theme file.