Panes
A pane is one running program in a terminal. Split, float, minimize and move panes to arrange your work.
The life of a pane
A pane runs the shell, or the command you give to isc run or isc split.
- When its program ends, the pane closes. A pane started with
isc run --keepstays open and shows how the program ended (done, orfailedwith the exit code). Press Enter in it to close it. - Closing a pane ends its program, without asking. The program gets a hang-up, then its terminal closes after 300 ms, and its process group is killed after three seconds.
- Close a pane with
Ctrl+Shift+W, the close button in its header, orisc close [PANE]. - When the focused pane closes, the keyboard goes to the pane that takes its space.
- A fault inside one pane closes only that pane.
Limits: a window or terminal shows at most 512 panes at once (the rest say "Not shown yet" and retry on their own), and a pane isn't shown if its terminal would have more than 1,024,000 cells.
Which shell runs
A pane with no command runs the first of these that applies:
- The
shellsetting, if set: a program and its arguments split at spaces, such as"fish"or"/bin/zsh -l". A path can't contain a space. $SHELLas the daemon sees it./bin/sh.
- A change to
shellapplies to the next pane; open panes keep theirs. - If your shell can't start, the login shell starts instead and the top bar says what went wrong.
shellchanges what new panes run, not$SHELLinside them.
What is known about a pane
Program: the foreground process's name. A pane that has printed and been sent nothing has no known program yet and shows the generic terminal icon.
Directory: read from the pane's own process, so it's right with any shell.
Title: what the program set, without a busy mark such as an agent's spinner.
isc lsshows the title exactly as set.Tile: chosen from the program's name. About six hundred programs have their own mark, in white on their maker's colour; a maker whose colour is black, as OpenAI or GitHub, gets a black mark on a white card, and a mark drawn in several colours, as Gemini's, Firefox's or Julia's, keeps them on a white card. Anything else gets the terminal's. To give your own program one, see Icons for your own programs. The list is fixed.
Kind Programs Agents claude, codex, gemini, copilot, cursor-agent, opencode, pi, amp, goose, hermes, openclaw, nemoclaw, cline, qwen, kiro, kilo, roo, kimi, trae, codebuddy, qoder, jules, junie, devin, openhands, grok, antigravity, zencoder, vibe, aider, crush, droid, auggie and paperclipai Models ollama, lms, vllm, deepseek, hf, nvidia-smi Editors nvim, vim, emacs, hx, zed, codium, subl, the JetBrains editors, xcodebuild Version control git, lazygit, tig, gitui, jj, gh, glab, hg, svn, git-lfs, tea, gt Rust, Go, Zig cargo, rustc, rustup, go, zig JavaScript node, npm, pnpm, yarn, bun, deno, tsc, vite, webpack, esbuild, next, nuxt, astro, ng, eslint, prettier, jest, vitest, turbo, nx, tailwindcss, gulp, babel, biome, sass, mocha, puppeteer, electron, tauri, expo, nest, ember Python python, ipython, pip, uv, ruff, pytest, jupyter, poetry, conda, django ( manage.py), flask, uvicorn, gunicorn, celery, streamlit, scrapy, pdm, ryeSites and services hugo, jekyll, gatsby, docusaurus, mkdocs, vitepress, wp, drush, firebase, stripe, shopify, newman, http (HTTPie), rover Ruby and PHP ruby, irb, rake, bundle, rails, gem, php, artisan (Laravel), composer, symfony Other languages lua, perl, R, julia, nim, crystal, elixir, erlang, ghc, ocaml, kotlin, swift, scala, clojure, dart, flutter, dotnet, java, gradle, mvn, cmake, make, gcc, clang, gleam, gfortran, racket, sbcl, elm, solc, octave, sage, groovy, typst, latex, pandoc, bazel, conan, just Databases psql, pgcli, mysql, mariadb, sqlite3, redis-cli, mongosh, clickhouse, duckdb, supabase, prisma, cqlsh, influx, cypher-shell, cockroach, etcdctl, rabbitmqctl, nats, pscale, turso, surreal, snowsql, bq, trino Data and learning spark-submit, pyspark, airflow, prefect, kafka-topics, hadoop, mlflow, dvc, wandb, tensorboard, kaggle, modal, quarto Containers and clouds docker, podman, kubectl, k9s, helm, terraform, tofu, ansible, vagrant, pulumi, gcloud, wrangler, vercel, netlify, fly, nginx, caddy, tailscale, doctl, hcloud, railway, serverless, sst, k3s, istioctl, argocd, flux, nerdctl, lxc, incus, qemu, VBoxManage, consul, vault, nomad, packer, prometheus, grafana, traefik, httpd, jenkins, act Security and networks op, bw, keepassxc-cli, openvpn, mullvad, tor, tshark, msfconsole, openssl, certbot, ngrok, snyk, trivy The system pacman, yay, apt, dnf, nix, brew, flatpak, tmux, curl, ffmpeg, mpv, htop, gpg, snap, zypper, apk, emerge, rpm, yum, pkg, port, rclone, borg, syncthing Devices and apps adb, fastboot, arduino-cli, pio, ros2, pod, fastlane, yt-dlp, vlc, blender, godot, firefox, obsidian Remote ssh, mosh, sftp, scp, rsync Monitors btop, top, nvtop, glances, btm Shells sh, bash, zsh, fish, nu, dash, ksh, pwsh A tool run by a language's program is known by its own name: Vite runs as
nodebut the pane is calledvite, and likewiserails,artisanandmanage. A script of your own staysnodeorpython. A shell script is known by its own name,deployfor./deploy.
The header
The header shows, in order: the icon; the title, or the name you gave the pane; the directory, unless the title has it; a mute mark; a crossed-out robot while the pane keeps agents out (see Agents); an eye or a keyboard while a guest can look at the pane or type in it; a chip with the state, when the pane isn't idle, with a percentage when the program reports progress, what the state is about and how long; "Floating" on a float; and "Enter closes" on a kept pane whose program has ended.
The focused pane has an accent outline and a tinted header. A pane that's waiting for you has an amber outline, an amber header and a glow round its edge.
Buttons show on the focused pane and the pane under the pointer: split right, split down, float (put into the layout, on a float), minimize and fill the tab, or "Stop filling" while the pane fills the tab; then ⋯ for the pane's menu, and close. Under the pointer the header also says how much memory the pane's programs use, and how much processor while they're busy. The pane's menu (⋯, or right-click the header) has the same five arrangements along its top, and everything else: rename, clear history, keep on top and show over every tab (on a float), share (see Sharing one project or one terminal), mute, keep agents out, and close. A pane on another machine has no share item.
The pane-header setting:
| Value | Header |
|---|---|
full (default) | Everything above |
name | The same, without the buttons |
hidden | No header; the terminal uses the space |
A floating pane keeps its name even with hidden, because you drag it by that bar. Changing this setting resizes the terminals.
Splitting and focus
- Split right / down:
Ctrl+Shift+O/Ctrl+Shift+E, the pane's menu, orisc split right|down [PANE] [-- COMMAND…]. The new pane takes half of the pane it splits. With a floating pane focused, the tiled layout is split. - Focus by direction:
Ctrl+Alt+arrow, orisc focus left|right|up|down, across tiled panes. - Next / previous pane, floats included:
Ctrl+Shift+]/Ctrl+Shift+[. - Click a pane to focus it.
isc focus PANEgives a pane the keyboard.
Resizing
With the mouse, drag the divider between panes. Ratios stay between 5% and 95%.
With the keyboard, Ctrl+Alt+Shift+arrow moves the focused pane's edge that way, by 5% of the space being divided. From the command line: isc resize left|right|up|down [PANE] [--by PERCENT].
- The arrow says which way the divider goes, not whether the pane grows: "right" widens a pane whose divider is on its right and narrows one whose divider is on its left.
- A pane as wide as the tab has no divider to move, so the key does nothing.
- On a floating pane, the same keys move its right and bottom edges.
Moving and swapping
- "Move this pane left / right / up / down" swaps a tiled pane with its neighbour on that side, and the pane keeps the keyboard. On a floating pane it moves it a twentieth of the tab, up to the tab's edges.
- The commands (
move-left,move-right,move-up,move-down) have no direct key. Use the palette or bind one in[keys]. After the leader they'reCtrl+H,Ctrl+J,Ctrl+K,Ctrl+L, and they repeat. isc swap A Bswaps the places of two panes.isc put PANE left|right|above|below --of OTHERmoves a pane to that side of another, half each. Without--ofthe pane takes that half of the whole tab, or of the tab--tabnames.
Drag a tiled pane by its header. Where you let go says what happens:
| Let go | What happens |
|---|---|
| In the middle of another pane | The two swap places |
| Near a side of another pane: within a quarter of it, 160 pixels at most | The pane takes that half of the other's place |
| Within 24 pixels of the tab's edge | The pane becomes a column, or a row, at that side of everything |
| On a tab, along the top or in the sidebar | The pane moves to that tab, at the right of what's there |
| Anywhere else | Nothing changes |
- You see it before it happens. The panes glide to where they'd be, and the pane you carry is ringed, with a word in its middle for what letting go does: "Swap", "Top half", "Left of everything".
- Escape puts it back while you're still holding it.
- A tab left with no pane is gone. You can't drag while one pane fills the tab.
Filling the tab (zoom)
Press Ctrl+Shift+Enter, choose "Fill the tab" in the pane's menu, or run isc zoom [PANE] [--off]. The pane fills the tab and the others keep their size underneath. "Stop filling" in its header puts it back.
Floating panes
A floating pane sits above the layout and works like any other pane. You can float as many as you like.
| To | Do |
|---|---|
| Open a new float | Ctrl+Shift+D, or isc run --float [--rect X,Y,W,H] |
| Float the focused pane, or put it back | Ctrl+Shift+G; isc float [PANE] [--rect X,Y,W,H], isc tile [PANE] |
| Move | Drag the header |
| Resize | Drag any edge or corner |
| Keep on top of other floats | Ctrl+Shift+K, the pane's menu, isc pin [PANE] [--off] |
| Put over the left half, right half, middle or whole tab | The palette commands float-left, float-right, float-centre, float-fill. They have no default keys. |
| Hide or show every float in the tab | Ctrl+Shift+H, the switch in the top bar, isc floats show|hide |
| Hide one float, and bring it back | isc hide [PANE], isc show PANE |
- A float stays inside the tab and is at least a tenth of it each way.
--recttakes fractions of the tab:--rect 0.5,0,0.5,1is the right half. The default is0.2,0.15,0.6,0.7.- Floating a tiled pane gives its space to its neighbours. Putting it back places it beside the focused tiled pane.
- Hidden floats keep running. A float closes when its command exits, like every pane.
Over every tab. To make a float show over whichever tab of the project is in front, in the same place and size, choose "Show over every tab" in the pane's menu, "Show this floating pane over every tab" in the palette, leader I, or isc follow [PANE] [--off].
- Closing a tab doesn't close it while the project has another tab.
- Minimized, it sits in the dock of the tab it was over.
The scratch pane
A quick shell for a one-off command, without disturbing your layout. Press Ctrl+` and a shell floats across the lower part of the tab with the keyboard. Press it again to put it away. After the leader the key is `; from the command line, use isc scratch [--project NAME].
- There's one scratch shell per project, the same over every tab. What runs in it keeps running while it's away.
- Its header and sidebar row say "scratch".
- If it's on screen but another pane has the keyboard, the key gives it the keyboard instead.
- It's an ordinary pane: move, resize, rename, tile, minimize or close it.
- Programs in panes don't get
Ctrl+`. To give it back, bind it tononein[keys]:"ctrl-`" = "none".
Minimizing and the dock
Minimize a pane to get it out of the way while its program keeps running. Press Ctrl+Shift+M, use the header button, or run isc minimize [PANE]. The pane leaves the layout and keeps its size.
- It waits in the dock as a chip: icon, title, percentage if reported, state mark, and a border in its state's colour. Chips stay in the order they were minimized.
- Restore: click the chip;
Ctrl+Shift+Rrestores the one minimized last;isc restore PANE. A tiled pane returns beside its old neighbours with its old share. A float returns to its rectangle. - A middle click on a chip closes the pane without asking.
minimize-othersandrestore-allare palette commands with no default keys.- Beyond about one chip per 170 pixels of the tab's width, idle minimized panes share one chip, "3 idle", which opens the palette. Working, waiting, done or failed panes keep their own.