isc commands
Run these in any terminal. Placeholders and options:
PANEis a pane's number (3orpane:3) or its name.TABis a tab's number (7ortab:7) or its name. A project is its name or number (4orproject:4).- A pane's or tab's name matches whatever its case; one that fits more than one does nothing and exits with status 3. A project's name must match exactly, and if two share it, the first listed is meant.
- Where
[PANE]is optional, the command acts on the pane you run it in, or outside any pane, on the pane with the keyboard. - Every command accepts
--socket PATH. Every command about a daemon also accepts--host NAMEto act on a named machine's daemon: see Other machines, over ssh. --rights look,typeasks the daemon for those rights and no others, oflook,type,arrangeandmanage: see Who is connected.
| Command | What it does |
|---|---|
isc ls [--json] | Lists projects, tabs and panes, a line each, with state, program, directory, name or title, whether it floats or is minimized, who opened it, and whether it keeps agents out. --json prints everything the daemon knows. isc list does the same. |
isc run [--cwd DIR] [--keep] [--name NAME] [--background] [--wait] [--json] [WHERE] [-- COMMAND…] | Runs a command in a new pane, or the shell if you give none, and prints the pane as pane:N. --cwd sets the directory (default: where you run isc). --keep keeps the pane when the command ends; press Enter, or use isc close, to close it. --name names it. --background leaves the keyboard where it is. --wait waits, prints the end of the output and exits with the command's status. --json prints the pane's and tab's numbers, and with --wait the status and output. Limits: 256 KB for a command and its directory, 4 MB for everything open, 4,096 panes. |
WHERE for isc run | Nothing: a new tab in the current project. --project NAME: a new tab in that project. --new-project [NAME]: a new project for the working directory, called NAME if given. --split right|down [--beside PANE]: beside a pane, sharing its space. --float [--rect X,Y,W,H]: floating above the current tab. |
isc split right|down [PANE] [--keep] [--name NAME] [--background] [--wait] [--json] [-- COMMAND…] | The same, beside a pane, in that pane's directory |
isc focus PANE, isc focus left|right|up|down | Gives a pane the keyboard: by number, or the focused pane's neighbour on that side |
isc float [PANE] [--rect X,Y,W,H] | Lifts a pane out of the layout, or moves one already floating. The rectangle is in fractions of the tab; default 0.2,0.15,0.6,0.7. |
isc tile [PANE] | Puts a floating pane back into the layout |
isc pin [PANE] [--off] | Keeps a floating pane above the others. --off stops that. |
isc follow [PANE] [--off] | Shows a floating pane over every tab of its project. --off shows it over its own tab only. |
isc hide [PANE], isc show PANE | Hides a floating pane while its program keeps running; brings it back to the front |
isc scratch [--project NAME] | Brings the project's scratch pane to the front, or puts it away if it's there with the keyboard. Starts it the first time. --project names a project other than the one in front. |
isc floats show|hide | Shows or hides the current tab's floating panes |
isc minimize [PANE], isc restore PANE | Puts a pane away, program running and size kept; brings it back where it was |
isc zoom [PANE] [--off] | Gives a pane the keyboard and lets it fill its tab. --off stops that. |
isc swap A B | Swaps the places of two panes |
isc put PANE left|right|above|below [--of OTHER] [--tab TAB] | Moves a pane to that side of another pane, or of all the panes of a tab |
isc resize left|right|up|down [PANE] [--by PERCENT] | Moves the divider a pane shares with its neighbours in that direction, by 5% of the divided space unless you set --by. |
isc rename PANE NAME | Names a pane, shown instead of its directory and title. "" removes the name. |
isc clear [PANE] [--tab [TAB]] [--project [NAME]] [--force] | Empties a pane's history and screen, or every pane's of a tab or project, and has each program draw again. Busy panes are named and nothing is cleared, unless you give --force. |
isc close [PANE] | Closes a pane and ends its program |
isc close --opened [PANE] | Closes every pane that isc run, isc split or isc agent start opened from inside the pane you run it in (or PANE), and those they opened, except one you've typed into or focused |
isc tab new | Opens a tab with a shell in the current project |
isc tab next, isc tab prev | Goes to the next or previous tab of the current project, wrapping round |
isc tab select TAB | Goes to a tab |
isc tab close [TAB] | Closes every pane in a tab, or the current tab |
isc tab move TAB INDEX | Moves a tab to a position among its project's tabs, counted from 0 |
isc tab rename TAB NAME | Names a tab. An empty name removes it. |
isc project new [DIR] [--name NAME] [--make] | Opens a project for DIR, or the current directory, named after it unless --name. DIR must exist: --make makes it, with its parents, on the machine the command is for, and opens nothing if that fails. On another machine, give DIR from / or ~. |
isc project open [FILE] [--again] [--yes] | Makes the project a file describes: see A project in a file. FILE is the file, or a directory holding .insensical.toml; default the current directory. An open project of the same name and root is gone to, unless --again. A file that starts programs asks first, and again when it changes; --yes answers for you. |
isc project save [FILE] [--force] | Writes the project in front as such a file: .insensical.toml in the project's directory, or FILE, or - for standard output. It won't write over a file without --force. |
isc project select NAME | Goes to a project |
isc project rename NAME NEW | Renames a project |
isc project icon NAME [--mark MARK] [--colour #rrggbb] [--svg FILE] | Chooses what a project is shown by. With none of them, it's the first letter of its name again. |
isc project move NAME INDEX | Moves a project to a position among the projects, counted from 0 |
isc project close NAME | Closes a project and everything running in it |
isc send PANE TEXT | Types text into a pane, as if at its keyboard |
isc upload PANE FILE… | Keeps files in the pane's directory, in .insensical-uploads, and types their paths into the pane, each followed by a space |
isc key PANE KEY… | Presses keys by name, in order: ctrl-c, enter, escape, shift-tab, a |
isc attach [PANE] | Shows a pane in this terminal and lets you type into it. Ctrl+] leaves. |
isc, isc tui | Draws the whole interface in this terminal. isc alone does so only for a person at a terminal; in a script, a pipe or one of insensical's own panes it lists the commands. Ctrl+Space then D leaves. See The whole interface in a terminal. |
isc capture PANE [--last [N]|--screen] [--tail N] [--grep PATTERN [--context N]] [--since TOKEN] [--all] | Prints the end of a pane's screen and scrollback as text, at most 4 KB, ending with a line that says what was left out and the token --since reads on from. --last is what the latest command printed and how it ended. |
isc ls [--program NAME] [--state STATE] [--opened] [--here] | Lists only the panes that fit, under the projects and tabs that hold them |
isc wait PANE --prompt|--quiet SECONDS|--address|--output PATTERN | Waits until the running command ends (printing the end of its output and exiting with its status), until nothing is printed for a while, until a local address is shown (printing it), or until a line matches (printing it) |
isc agent start AGENT TASK [--split right|down | --tab] [--front] [--cwd DIR] [--name NAME] [--json] [--quiet [--timeout SECONDS]] | Starts claude, codex or gemini with a task in a new pane and prints it; with --quiet, alone, printing only its answer. See Agents. |
isc agent wait PANE, isc agent reply PANE | Waits for an agent's turn to end and prints its whole reply or its question; prints its last reply |
isc agent tell PANE MESSAGE, isc agent answer PANE yes|no|TEXT | Gives an agent its next prompt, now or when its turn ends; answers its permission prompt |
isc ask PANE TEXT [--quiet SECONDS] [--anyway] [--timeout SECONDS] | Types a line and Enter, waits for the answer and prints only it; at a shell that marks its commands, exits with the command's status |
isc history PANE [--all] [--json] | Prints the commands run in a pane, newest last: when, how long, how each ended, where, and what was typed |
isc capture PANE --vt | Prints all of a pane's screen and scrollback with colours and styles, as escape sequences |
isc status STATE [-m MESSAGE] [--resume COMMAND] [-p PANE] | Reports what a pane is doing: idle, running, waiting, done or failed. -m (--message) says what it's about. --resume is a command that picks the work up again, offered at the pane's prompt after the daemon has stopped. -p (--pane) is required outside a pane. |
isc status explain [-p PANE] | Explains why a pane is in its current state |
isc status clear [-p PANE] | Forgets what a program or hook reported for a pane, and puts it at rest |
isc notify TITLE [BODY] [-p PANE] | Asks for your attention on a pane's behalf |
isc notify --test | Runs notify-command and posts to notify-url now, and says how each went |
isc notify --sinks | Says what those two are set to, how the last send to each went, and how many weren't sent |
isc mute [PANE] [--off] | Stops a pane sending notifications. --off lets it again. Its state still shows. |
isc protect PANE [--off] | Keeps agents out of a pane: a program in another pane can't read it, wait on it or type into it, and isc there exits with 4. --off lets them in, and is refused in a pane. |
isc integrate [AGENT] [--remove] [--yes] [--force] | Sets an agent up to use insensical (hooks, a skill and a note at each session's start), after showing you the change and asking. With no agent named, offers each one found. --remove takes them out. --yes skips the question. --force replaces a skill of that name you wrote. |
isc integrate [AGENT] --status | Changes nothing. Prints, as JSON, for each agent whether it's found and set up, how its hooks, skill and note stand, and what's left for you |
isc guide [layout|reading|acting|waiting|agents] | Prints the guide agents are taught: where they are, where to act, one topic at a time. |
isc wait PANE [--until STATE]… [--timeout SECONDS] | Blocks until the pane reaches a state: idle, running, waiting, done, failed or closed. Without --until: done, failed, waiting or closed. Prints the state reached. Exits with 124 when time runs out. |
isc wait PANE --output TEXT [--timeout SECONDS] | Blocks until the pane's screen or history shows the text. Exits with 124 when time runs out. |
isc events | Prints what happens, one JSON object per line, until interrupted |
isc api [REQUEST] | Sends the daemon one request as JSON, from the argument or standard input, and prints the answer as JSON |
isc api [--json], isc api NAME [--json] | Lists every request, or says what one holds, with an example. Needs no daemon. |
isc do NAME [--yes] | Runs a command by name: one of your own from [commands], or one of the window's. Stops at the first step that fails. --yes goes ahead where a step would end what's running. |
isc project sleep NAME | Ends every program in the project and keeps its tabs, panes and what they showed. Doesn't ask. |
isc project wake NAME | Puts a shell in each pane of a sleeping project, in the pane's directory |
isc project mute NAME [--off] | Stops every pane of the project sending notifications, including panes opened later. --off lets them again. |
isc usage [--json] | Prints what the programs in each pane use: memory, processor time and process count, with a total for each project |
isc clients [--json] | Lists the windows, browsers, isc tui and hub notifications connected to the daemon, one session each: what it is, its machine or device, version, rights, connections, process, and the pane it's looking at |
isc disconnect SESSION | Ends every connection of another session, by the number isc clients shows (7 or session:7). Needs the right to manage. |
isc config | Prints a settings file with every setting at its default and every key of both keymaps |
isc config get NAME | Prints a setting's value from the file, or its default. With --host, from that machine's file. |
isc config set NAME VALUE | Gives a setting a value, changing only that line. With --host, one of the daemon's settings on that machine. --stdin in place of VALUE reads it from standard input, out of sight of other users. |
isc config reset NAME | Takes a setting out of the settings file, leaving its default. With --host, as set. |
isc completions bash|zsh|fish | Prints what that shell needs to complete isc commands, including the panes, tabs and projects that exist |
isc shell-integration bash|zsh|fish | Prints what that shell needs to tell its pane where each command starts and ends, and its exit status. fish 4 and later doesn't need it. |
isc host add NAME WHERE | Names another machine. WHERE is what you'd give ssh. --icon I and --careful set those on it. A tailnet machine is kept by its node; --no-node keeps it as typed. |
isc host set NAME | Changes what's set on a machine: --ssh WHERE, --icon I or --no-icon, --careful or --no-careful, and --name NEW to rename it. Only what you give changes. |
isc host ls | Lists the machines you've named, with where ssh goes and what's set on each. --json includes node. |
isc host answer NAME | Runs your ssh to the machine at your terminal so it can ask: a host key, passphrase, password or sign-in. Then it meets the machine, and succeeds only if it was reached. NAME can be where ssh goes. |
isc host rm NAME | Forgets a machine's name |
isc host check NAME | Meets the machine and prints four lines: reached and round trip, a working insensical version, server running, and what's open. A failing line says what to do. It changes nothing there, and exits non-zero unless the machine is ready. |
isc host restart NAME [--yes] | Restarts the server on a machine running an older version than its installed isc. It says what that comes to and asks; --yes doesn't. A server that can move keeps what runs in its panes. |
isc host put NAME | Brings this version's isc to a machine over ssh, never a newer one. An isc there that can update itself runs isc upgrade --version for this version; if it can't reach GitHub, a Linux machine is sent a copy in ~/.local/bin instead, with no sudo. A copy a package or Homebrew owns is left alone, and you get the command to run there; so is one built from source, and you're told to build the new version there. A copy built from source sends itself to a Linux machine. It asks first; --yes doesn't. A server running there is left alone unless you pass --restart-server or answer yes to a second question. |
isc proxy | What isc --host runs on the other machine, through ssh. You don't run it yourself. |
isc hub [--port N] [--listen ADDR] [--tls-cert FILE --tls-key FILE] [--name NAME]… [--guest-port N] [--guest-name NAME]… | Serves insensical to a browser, on this machine only unless given a certificate. --name is another name browsers reach it by. --guest-port (7434) and --guest-name are the port and names of the door a public address leads to. See In a browser |
isc hub setup | Walks you through reaching this computer from a browser or phone: hub or joined machine, how you'll reach a hub, starting by itself, and adding a device with its code. It ends on the equivalent commands. |
isc hub device add | In a terminal, with no --name: opens a form that asks for the name and the rest, starting from the flags you gave, and ends on the code to scan |
isc hub device add --name NAME [--rights …] [--uses N|any] [--expires 10m|never] [--stays 1h|1d|always] [--only project:NAME|pane:N] [--far] [--public] [--url BASE] [--json] | Adds a device and prints its code once, as a link and a code to scan. The link pairs one browser for ten minutes unless told otherwise. --stays is how long the device stays paired. --only makes a guest that sees one project or terminal and may look, or look and type. |
isc hub device pair-again NAME [--expires TIME] [--url BASE] [--json] | Makes a new one-use code for a paired device; the browser that pairs with it replaces the device's browsers |
isc hub device ls [--json], isc hub device rm NAME [--with-approved] | Lists the devices, with what each sees and which device added it; ends one and closes every browser paired with it, and with --with-approved the devices it added from its page |
isc hub device set NAME --far|--no-far | Lets a paired device open your other machines' terminals through this computer, or keeps it to this one |
isc hub push ls [--json], isc hub push test [--at MACHINE] [--json] | Lists the browsers sent notifications, and which hear your other machines; sends each a test and says how its push service answered. --at tests as from that machine. |
isc hub open [--print|--json] | Opens insensical in your browser on this computer, signed in as This computer, from an address that works once, for ten minutes. --print or --json prints it and opens nothing. |
isc hub status [--json] | Says whether isc hub is running, where, what keeps it running and whether it's the installed version |
isc hub start [OPTIONS], isc hub stop | Turns the hub on and keeps it running, back after a login (a user service, switched on, and lingering) or when the window opens; stops it now and turns it off |
isc hub restart [OPTIONS] | Starts the running hub again as the installed isc, on its port, with the options given kept |
isc hub tailscale on, off, status [--json] | Has Tailscale serve isc hub to your tailnet at https:// and this computer's name; takes that mapping away; says whether it's served, and why not |
isc hub invite NAME [--url BASE] [--json] | On the hub, prints a line that joins one machine to it, within ten minutes. See Joining another machine to your hub |
isc hub join, isc hub leave | Joins this machine to the hub of a line invite printed, read from the terminal or standard input; leaves it, and the hub forgets it, so isc hub listens again |
isc hub machine ls [--json], isc hub machine rm NAME | On the hub, lists the machines joined to it; takes one away at once, by its name or id |
isc hub ban ID, isc hub unban ID | On the hub, carries nothing more for a device, by its id; lifts that |
isc hub rekey | Gives this machine a new key and id: each device pairs with it again, and a joined machine joins its hub again |
isc hub public on, off, status [--json] | Has Tailscale Funnel open a public address to devices made with isc hub device add --public; removes those devices and the address; says whether one is open, where, and for which devices |
isc tmux COMMAND… | Answers a tmux command with insensical's panes, as the tmux a pane finds with tmux-shim on does. See Agents. |
isc daemon | Runs the daemon in the foreground |
isc kill-server | Stops the daemon and every program it runs, and returns once it's gone. The layout comes back the next time it starts. Also works on a daemon of another version. |
isc restart-server [--yes] | Moves the running daemon to this version while the programs in its panes keep running. It asks first, and exits 1 on no; --yes skips the question. With no daemon running, it starts one. |
isc upgrade [--version X] [--check [--json]] [--yes] | Downloads the latest release's signed record and this machine's file, checks the file against the record, and replaces yours: isc alone, or insensical and isc from the tarball together. It asks first; --yes doesn't, and with no terminal and no --yes nothing is installed. Where the directory needs a password, it uses sudo. --version installs that release, older or not; without it, an older one is never installed. --check says what there is and installs nothing; with --json it prints one object, {"running": "0.6.0", "latest": "0.6.1" or null, "update": ""}, where update is empty if this copy can replace itself and otherwise says who updates it. A copy from a package or Homebrew isn't replaced: it prints the command that updates it. A copy built from source says "This copy was built from source. Build the new version the same way." It exits with status 1 when there's a newer version and nothing was installed. |
isc version | Prints this version and the running daemon's, with the protocol and terminal engine of each, the daemon's process number, and whether they can talk to each other. A copy built from source shows its commit after the version, as 0.7.0+91c21a3d, with -dirty added if it had uncommitted changes. While isc hub runs, one line gives its version and process number, and says if a newer one is installed. When a newer release is known, one more line says so |