Install
Releases are at https://insensical.com/download, each file with its SHA-256 beside it.
Arch Linux. Install from the AUR:
yay -S insensical-binDebian 12 and later, Ubuntu 24.04 and later, on x86-64. Download the .deb, then:
sudo apt install ./insensical_*_amd64.debThere's no apt repository. To update, install the new .deb the same way.
Other Linux, on x86-64 with glibc 2.36 or later. Unpack the tarball and put insensical and isc together in a directory on your PATH. It also holds the desktop entry, the icon, the user unit and completions for bash, zsh and fish; put them where your system looks for them.
The window is built for x86-64 only. On an ARM machine, install isc by itself.
Without the window, on any Linux, x86-64 or arm64, with or without a desktop. isc alone is the daemon, the command line and the whole interface in a terminal, in one file that needs nothing installed. The packages above install the same isc beside the window.
curl -fsSL https://insensical.com/install.sh | shIt downloads isc-x86_64-linux (isc-aarch64-linux on ARM) and its checksum from the latest release, and installs the file only if they agree. If minisign is installed, it also checks the signature. Run the same line to update.
| Set | Effect |
|---|---|
ISC_VERSION=0.3.1 | Installs that release instead of the latest. isc --version prints yours. |
ISC_DIR=~/.local/bin | Installs there, with no password. The default is /usr/local/bin/isc, using sudo if needed. |
ISC_QUIET=1 | Asks nothing and restarts nothing. It stops if the directory needs a password. Also the behaviour when there's no terminal to ask on. |
Put the variable before sh, as in curl -fsSL https://insensical.com/install.sh | ISC_DIR=~/.local/bin sh.
- An
iscalready on yourPATHis replaced there, except/usr/bin/isc, which a package owns: update that with your package manager. - If a daemon is running, it asks whether to restart it, and Enter says yes. Restarting ends nothing in your panes. Say no and run
isc restart-serverwhen it suits you. - Completions aren't installed.
isc completions bash,zshorfishprints them. - The checksum catches a damaged download, not a wrong release.
The same by hand:
cd "$(mktemp -d)"
curl -fLO https://github.com/mah3uz/insensical-release/releases/latest/download/isc-x86_64-linux -O https://github.com/mah3uz/insensical-release/releases/latest/download/isc-x86_64-linux.sha256
sha256sum -c isc-x86_64-linux.sha256 && install -m755 isc-x86_64-linux ~/.local/bin/isc
iscOn ARM the file is isc-aarch64-linux. For one release, put download/v0.3.1 where it says latest/download. A machine that can't reach the release needs only those two files, copied to it. Replacing the file doesn't stop a running daemon; isc restart-server --yes moves it to the new version with everything still running.
macOS 13 and later, on Apple silicon. With Homebrew, which also puts isc on the PATH:
brew install --cask mah3uz/tap/insensicalOr open the .dmg and drag the application to Applications. It isn't signed with a Developer ID or notarised, so macOS won't open a downloaded copy until you clear the quarantine flag (Homebrew does this for you):
xattr -dr com.apple.quarantine /Applications/insensical.appisc is at /Applications/insensical.app/Contents/MacOS/isc. There's no build for an Intel Mac.
Starting at login. Set At login in Settings > General. Open the window opens insensical when you log in; Start in the tray (Start in the menu bar on a Mac) starts it with no window. Do nothing turns it off.
On Linux this adds insensical.desktop to ~/.config/autostart, and Start in the tray opens the window if your desktop shows no tray or tray is off. Plain Hyprland, without uwsm, ignores that folder: add exec-once = insensical to its config.
On a Mac, insensical adds itself to System Settings > General > Login Items. If macOS asks, allow it there; the row says when it's waiting or turned off. The menu bar item or the Dock icon opens a window.
On a machine with no desktop, run systemctl --user enable --now insensical instead. Its shells get systemd's environment (see The daemon's environment). You don't have to do either: the first window or command that needs the daemon starts it. Upgrading the package only replaces files; the running daemon carries on until you move it (see A new version).
What any uninstall leaves:
- your settings, in
~/.config/insensical; - the saved layout, what the panes showed, the window's size and your recent palette choices, in
~/.local/state/insensical(on a Mac,~/Library/Application Support/insensical); - what
isc hubkeeps (its keys, paired devices and joined machines), in~/.local/share/insensical/hub(on a Mac,~/Library/Application Support/insensical/hub); - hooks added to an agent's own settings. Run
isc integrate AGENT --removebeforeiscis gone; - a daemon that is running, with every program in its panes. Run
isc kill-serverfirst to end it.
Delete the two directories to be rid of everything.
What it needs
- Linux: x86-64 with glibc 2.36 or later for the window;
iscalone also runs on arm64. The window needs Wayland or X11 and Vulkan. - macOS: 13.0 or later.
- Fonts: none in particular. The default is
JetBrainsMono Nerd Font. The window draws its own icons and carries an icon font for the Nerd Font icons programs print.
The two binaries must be together
The window finds the daemon in this order: the file $INSENSICAL_ISC names, the isc beside the window, then isc on PATH. If none exists, it says the server cannot be reached.
The icon
At 16 to 32 px, in a tray or a notification, the icon is the terminal chip alone. A taskbar or switcher shows it only if the desktop can match the window to the desktop entry, so the window names itself insensical.
- Run without installing, the window gets a generic icon.
- An old
icon-theme.cachein~/.local/share/icons/hicolorcan hide the icon. Rebuild it withgtk-update-icon-cache --force --ignore-theme-index ~/.local/share/icons/hicolor. A running launcher or panel may keep the old picture until you restart it.
Starting it
Start insensical from a launcher or a terminal. If no daemon is running, the window starts one, and without a settings file the defaults apply.
Where you start it matters twice. The first project is made from the directory you start it in (see First launch), and the daemon takes the environment of whatever started it (see The daemon's environment).