Skip to main content

Arrange the console's windows

The web console shows one slot's session at a time. A node often runs several sessions, one per slot, and each one is a window the console can show. Console layout splits the console into tiles to show up to four of those windows at once, or group some of them as tabs in one tile. This browser keeps the layout for that slot and puts it back the next time you open its console.

Who can do this: anyone who can open the slot's console. The Open web console button shows only when you may act on the task, and it needs the permission to view worktrees. Console layout shows only in a window wider than 480 pixels, and never on the console of a task that runs in a MicroVM.

  1. Open the task and select the Open web console button beside its state at the top of the page.

  2. In the console's header, select Console layout (▦). The Console layout window opens on a picture of the console. On first use it shows one tile, with every window on the node as a tab along the tile's top.

  3. Drag a tab onto the edge of a tile to split that tile in two, with the window in the new half. A blue outline shows where it will land before you let go.

  4. Drag a tab onto another tile's tab strip to group it there as a tab instead.

  5. In a tile with several tabs, select the tab the tile should show. Its name shows in the middle of the tile. Hover a shortened tab name to read it in full.

  6. If a drop zone turns red, read its reason. A tile needs room for 80 by 20 characters, so a split that would leave less is refused with Enlarge the console to split further. At most four tiles fit side by side. Widen or maximize the console, then open Console layout again.

  7. Select Apply. The console reconnects and shows the tiles. To start over, select Reset for one tile with every window as a tab; Cancel or Esc closes without a change.

Narrowing the window to phone width drops the layout and shows the slot's own session again. When a saved layout names a window that has since closed, the console shows the layout without it.

Terminal keys, the bar under the terminal, sends Esc, Tab, the four arrows and ^C, keys a phone keyboard lacks. It is gone on a read-only console and while the console shows Chat.