Settings
Settings go in config.toml. Every key is optional, and an unknown key is an error.
| Key | Meaning | Default |
|---|---|---|
appearance | Whether the window is light or dark. system follows the desktop; light and dark hold it there. | system |
terminal-appearance | Whether 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 |
theme | A 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-family | The terminal font. | JetBrainsMono Nerd Font |
interface-font | Font for tabs, sidebar, headers and panels | Inter |
interface-style | insensical: 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-opacity | How 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-opacity | How 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-blur | Whether 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-login | What 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 |
motion | Whether sheets, notices and moved panes fade in, the working mark turns and cursors blink. system follows the desktop. | system |
font-ligatures | Whether symbols side by side are drawn as the font's ligature, such as -> and != | true |
font-size | Terminal text size in points, 6 to 72. | 12; on macOS 13 |
density | comfortable: each pane is a rounded card with space around it. compact: panes sit edge to edge with a hairline between. | comfortable |
pane-gap | Space between panes in pixels, 0 to 40 | 12, or 0 when density is compact |
sidebar-tree | Tree view: what each project holds, joined by tree lines. false lists a project's tabs flat, with no lines and no panes. | true |
sidebar | The 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-idle | Whether agents at rest are listed when the sidebar shows only activity | true |
tabs | Where tabs show. sidebar: down the side, for every project. top: along the top, for the current project. | sidebar |
pane-header | full: what the pane is and does, plus arrange buttons. name: the same without buttons. hidden: no header; a floating pane keeps its name. | full |
keymap | direct: each command has its own chord. leader: each command is a key pressed after the leader, leaving the chords to the programs. | direct |
leader | The key pressed before a command's key when keymap is leader | ctrl-space |
shell | What a pane runs when you give it no command, with arguments: "fish", "/bin/zsh -l". | the login shell, $SHELL |
input-method | Whether your system's input method may compose text in a pane, as for Bangla, Chinese or Japanese. | false |
option-as-alt | On 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-ahead | Whether 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-with | What 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 |
term | The 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 |
scrollback | History each pane keeps, in megabytes, 1 to 200. | 10 |
keep-scrollback | Whether 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-updates | Whether 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-awake | On 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-once | How many agents one agent can have open at once, started with isc agent start, 1 to 64 (Agents). | 8 |
agents-deep | How deep agents can start agents, 1 to 8. | 2 |
agents-from-other-machines | Whether 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-shim | Whether 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 |
clipboard | Whether 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 |
notifications | Whether you're told when a pane has something for you. | true |
attention-glow | Whether a waiting pane takes the waiting colour at its edge and casts a soft light into the gaps around it | true |
notify-waiting | Whether you're told when a pane waits for you, or a program asks for you. | true |
notify-failed | Whether you're told when a command or agent ends badly. | true |
notify-done | Whether you're told when a long command or an agent's turn ends well. | true |
notify-command | A program and arguments the daemon runs to tell you. See When nobody is attached. | none |
notify-command-when | When the command runs. away: only with no window, terminal or browser attached. always: every time. | away |
notify-url | An http or https address the daemon posts to, to tell you | none |
notify-url-when | When it's posted to: away or always, as for the command | away |
notify-url-body | What's posted. json: the title, the message and the rest. text: the message alone, with the title in a Title header. | json |
notify-url-token | A token sent as Authorization: Bearer … with what's posted. A secret, shown masked. | none |
notify-url-user, notify-url-password | A user and password sent as Basic. The token wins if both are set. Secrets. | none |
notify-url-headers | A table of headers sent with what's posted, for a token. Shown masked; set it with isc config set. | none |
long-command | Seconds 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 |
sound | Which 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 |
tray | On Linux, whether insensical has a tray icon, marked while a pane needs you, with a menu of those panes. | true |
menu-bar | On a Mac, whether insensical has a menu bar item that counts and lists the panes that need you. | true |
dock-badge | On 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 mouse | colours = "auto", mouse = true |
[keys] | Keys and the command each one runs, or none, in either keymap | empty |
[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.