Environment variables
| Variable | Read by | Meaning |
|---|---|---|
INSENSICAL_SOCKET | everything | The daemon's socket. Set inside every pane. |
INSENSICAL_PANE | isc | Set inside every pane to its number, so commands run there know which pane they're in. |
INSENSICAL_STATE_DIR | daemon, window | Where the layout, what panes showed and the declined agents are kept. |
INSENSICAL_CONFIG_DIR | window, daemon | Where settings and themes are read from. |
INSENSICAL_SCOPE | window, isc | 1 starts a daemon on a socket you named in a systemd scope of its own, as the one on the default socket is. 0 starts it in none. See The daemon. |
INSENSICAL_NOTIFICATIONS | daemon | clients makes the daemon leave desktop notifications to its windows, and put no icon in the tray. |
INSENSICAL_WEB_FILES | isc hub | A directory to serve the page from, in place of the files built into isc. For working on the page. |
INSENSICAL_ISC | window, isc | The isc binary to start the daemon from. When set, it's used before the isc beside the program and the one on PATH. |
INSENSICAL_HOST | isc | The name of another machine, as --host takes it. Every command about a daemon then acts on that machine's, except the ones that end something (kill-server, close, tab close, project close, project sleep), which want --host on their own line. --socket given on the command line comes first. The daemon doesn't pass it on to its panes. |
INSENSICAL_SSH | isc | A program to run in place of ssh to reach another machine, with the same arguments. |
INSENSICAL_TAILSCALE | isc, the application | A program to run in place of tailscale, with the same arguments. When set, no other place is looked in. |
INSENSICAL_SYSTEMCTL, INSENSICAL_LOGINCTL | isc, the application | A program to run in place of systemctl, or loginctl, when isc hub start, isc hub tailscale and the settings sheet start and keep isc hub running, with the same arguments. |
INSENSICAL_ISC_X86_64, INSENSICAL_ISC_AARCH64 | isc | A file on this machine to send as isc when insensical is put on another machine with that processor. When set, it's sent in place of the release's file. It has to be an isc for Linux in the version you have here. |
SHELL | daemon | What a pane runs when there's no command and no shell setting. /bin/sh if unset. |
TERMINFO, HOME | daemon | Searched for Ghostty's terminal description. |
TERMINFO_DIRS | daemon | Kept, after the daemon's own directory, when it points a pane at the description it compiled. |
XDG_CONFIG_HOME | window, daemon, isc | Where the settings directory is, instead of ~/.config. Ghostty's and opencode's directories are also looked for here. |
XDG_DATA_HOME | isc, the application | Where the hub's folder is, under insensical/hub, instead of ~/.local/share. Linux only. |
INSENSICAL_DATA_DIR | isc, the application | A folder used in place of insensical under the data directory. The hub keeps its keys and devices in hub inside it. |
XDG_STATE_HOME | daemon, window | Where the state directory is, instead of ~/.local/state. Linux only. |
XDG_RUNTIME_DIR | everything | Where the socket's directory is, on Linux. Where ssh runs isc proxy without it, /run/user/ and your user's number is used if it's there, and otherwise run under the state directory. |
TMPDIR | everything | Where the socket's directory is, on macOS. |
PATH | daemon, window, isc | Every pane inherits the daemon's. The window's is searched for isc and for the program that shell names. isc integrate searches its own for agents. |
CLAUDE_CONFIG_DIR, CODEX_HOME, GEMINI_CLI_HOME, PI_CODING_AGENT_DIR | isc integrate | Where each agent keeps its settings, instead of its default directory. |
Set in every pane: TERM, COLORTERM=truecolor, TERM_PROGRAM=insensical, TERM_PROGRAM_VERSION, INSENSICAL_PANE, INSENSICAL_SOCKET. On a Mac with no locale set, LANG too.
Set for notify-command: INSENSICAL_EVENT, INSENSICAL_TITLE, INSENSICAL_BODY, INSENSICAL_KIND, INSENSICAL_PANE, INSENSICAL_PROJECT, INSENSICAL_MACHINE and INSENSICAL_PROGRAM. See When nobody is attached.