Skip to content

Panes ​

Panes, in under a minute, with sound

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 --keep stays open and shows how the program ended (done, or failed with 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, or isc 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:

  1. The shell setting, if set: a program and its arguments split at spaces, such as "fish" or "/bin/zsh -l". A path can't contain a space.
  2. $SHELL as the daemon sees it.
  3. /bin/sh.
  • A change to shell applies 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.
  • shell changes what new panes run, not $SHELL inside 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 ls shows 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.

    KindPrograms
    Agentsclaude, 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
    Modelsollama, lms, vllm, deepseek, hf, nvidia-smi
    Editorsnvim, vim, emacs, hx, zed, codium, subl, the JetBrains editors, xcodebuild
    Version controlgit, lazygit, tig, gitui, jj, gh, glab, hg, svn, git-lfs, tea, gt
    Rust, Go, Zigcargo, rustc, rustup, go, zig
    JavaScriptnode, 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
    Pythonpython, ipython, pip, uv, ruff, pytest, jupyter, poetry, conda, django (manage.py), flask, uvicorn, gunicorn, celery, streamlit, scrapy, pdm, rye
    Sites and serviceshugo, jekyll, gatsby, docusaurus, mkdocs, vitepress, wp, drush, firebase, stripe, shopify, newman, http (HTTPie), rover
    Ruby and PHPruby, irb, rake, bundle, rails, gem, php, artisan (Laravel), composer, symfony
    Other languageslua, 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
    Databasespsql, 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 learningspark-submit, pyspark, airflow, prefect, kafka-topics, hadoop, mlflow, dvc, wandb, tensorboard, kaggle, modal, quarto
    Containers and cloudsdocker, 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 networksop, bw, keepassxc-cli, openvpn, mullvad, tor, tshark, msfconsole, openssl, certbot, ngrok, snyk, trivy
    The systempacman, 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 appsadb, fastboot, arduino-cli, pio, ros2, pod, fastlane, yt-dlp, vlc, blender, godot, firefox, obsidian
    Remotessh, mosh, sftp, scp, rsync
    Monitorsbtop, top, nvtop, glances, btm
    Shellssh, bash, zsh, fish, nu, dash, ksh, pwsh

    A tool run by a language's program is known by its own name: Vite runs as node but the pane is called vite, and likewise rails, artisan and manage. A script of your own stays node or python. A shell script is known by its own name, deploy for ./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:

ValueHeader
full (default)Everything above
nameThe same, without the buttons
hiddenNo 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, or isc 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, or isc 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 PANE gives 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're Ctrl+H, Ctrl+J, Ctrl+K, Ctrl+L, and they repeat.
  • isc swap A B swaps the places of two panes.
  • isc put PANE left|right|above|below --of OTHER moves a pane to that side of another, half each. Without --of the pane takes that half of the whole tab, or of the tab --tab names.

Drag a tiled pane by its header. Where you let go says what happens:

Let goWhat happens
In the middle of another paneThe two swap places
Near a side of another pane: within a quarter of it, 160 pixels at mostThe pane takes that half of the other's place
Within 24 pixels of the tab's edgeThe pane becomes a column, or a row, at that side of everything
On a tab, along the top or in the sidebarThe pane moves to that tab, at the right of what's there
Anywhere elseNothing 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 ​

Float and dock, in under a minute, with sound

A floating pane sits above the layout and works like any other pane. You can float as many as you like.

ToDo
Open a new floatCtrl+Shift+D, or isc run --float [--rect X,Y,W,H]
Float the focused pane, or put it backCtrl+Shift+G; isc float [PANE] [--rect X,Y,W,H], isc tile [PANE]
MoveDrag the header
ResizeDrag any edge or corner
Keep on top of other floatsCtrl+Shift+K, the pane's menu, isc pin [PANE] [--off]
Put over the left half, right half, middle or whole tabThe palette commands float-left, float-right, float-centre, float-fill. They have no default keys.
Hide or show every float in the tabCtrl+Shift+H, the switch in the top bar, isc floats show|hide
Hide one float, and bring it backisc hide [PANE], isc show PANE
  • A float stays inside the tab and is at least a tenth of it each way.
  • --rect takes fractions of the tab: --rect 0.5,0,0.5,1 is the right half. The default is 0.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 to none in [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+R restores 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-others and restore-all are 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.