Skip to content

Terminals

Every chat's terminal opens right in the app, on whatever computer it runs: in a tab, in its own window, or as a floating sheet over the board. Your own shells open the same way.

Open a chat's terminal

How Where it opens
Enter on a card, or a double-click A tab
Shift+Enter Its own window
Alt+Enter (Option+Enter on a Mac) A floating sheet over the board
Cmd+O, then type a few letters A tab, for any chat

A stopped chat is resumed into the tab. The terminal is the chat itself (Claude Code's claude attach), so closing a window only detaches it, while closing a tab stops the chat unless you marked it Keep running. Typing exit (or /exit) closes its tab.

Behind another router

A computer linked with a code keeps one outgoing link to your server's hub, and its terminals travel over that link. No ssh and no port forwarding is needed, wherever the computer is.

Your own shells

Cmd+T opens a terminal with your default shell, on the computer you're at. Nothing goes through the server. The + at the end of the tab row lists every shell it found:

  • Mac and Linux: your login shell first, then zsh, bash, fish, nu, pwsh and the others in /etc/shells.
  • Windows: PowerShell 7, Windows PowerShell, Command Prompt, Git Bash, and each WSL distribution.

Pick the default in Settings, Terminal. On a Mac and Linux, closing a shell that's running a program asks first.

Tabs

Right-click a tab for Star tab, Rename chat, the group options, Move to a new window, Show as a floating sheet and Close tab. Drag a tab to reorder it, or down out of the row to give it its own window. Cmd+1 is the board, Cmd+2 to Cmd+8 the tabs in order, Cmd+9 the last one.

With more tabs than fit, the row scrolls sideways, with an arrow at each end, and the one you're on stays in sight. The list button just before + (it shows how many tabs are open) lists every tab, starred first, then each group under its name: click one to go to it (a folded group opens), or its x to close it.

Groups

Add to new group in a tab's menu starts a group in the next free color: Blue, Red, Yellow, Green, Pink, Purple, Cyan or Grey. Type its name on the chip. Click the chip to fold the group; right-click it to rename, recolor, move, ungroup or close it. Groups follow a chat through Start fresh, Continue and Resume, and are the same on every computer you use the app on (which tabs are open, and folding, stay on each one).

Rename a chat

Double-click a tab's title, type, and press Enter (Esc puts it back). The name shows everywhere, and in Claude Code's own /resume list. Names

Copy and paste

Select text with the mouse and it is copied. Ctrl+C copies while text is selected, on every computer; with nothing selected it interrupts the program as usual. Cmd+C and Cmd+V work on a Mac, and Ctrl+V pastes on Windows and Linux (so it no longer reaches the program there). A right-click copies the selection, or pastes when nothing is selected. An image on the clipboard is sent to the chat's computer and its path pasted.

A program that uses the mouse itself gets your clicks and drags; hold Shift to select and right-click as usual. All the keys

Drag files in

Drop files on a chat's terminal to send them to its computer: each one is uploaded there (up to 20 MB) and its path is typed into the chat. On your own shell, a dropped file types its path at the cursor. You can also paste files, or use Attach.

When the connection drops

A dropped terminal reconnects by itself, trying for about five minutes, and keeps what you could see and scroll back to. Reconnect now tries right away. If the screen ever looks wrong, Redraw (Cmd+Shift+R) asks for a fresh copy of it.

Look

Settings, Terminal has the color scheme (hover one to preview it in every open terminal), the text size (9 to 24, or Cmd++ and Cmd+- in a terminal), the cursor shape (block, bar or underline) and blinking. Schemes: Converge Dark and Light, Tokyo Night and Tokyo Night Day, Nord, Dracula, Gruvbox Dark and Light, Solarized Dark and Light, GitHub Light, Catppuccin Latte, or Match the app. These follow you to your other computers.