Terminal
A window onto the CLI TUI, exactly as it is
The terminal is a window that shows the Claude Code or Codex TUI as it is. It draws what the agent draws, colours and all.
Giving it room
Fold away the board on the left and the files on the right, and the terminal takes the space they used. This is handy for reading long logs or diffs. The terminal can also be split left and right to sit two side by side.
Controls
The bar above the terminal holds the controls you reach for most.
| Control | What it does |
|---|---|
| Search | Finds text in the screen and the scrollback (Cmd+F) |
| Copy | Copies the selection (Cmd+C) |
| State | The state of the session (working / waiting / finished) |
Starting a new line in the input box
In the Claude Code and Codex input box, Shift+Enter starts a new line. Plain
Enter sends. The chat input box works the same way.
Right-clicking
Right-click the terminal to choose copy, paste, or search. Copy is available while you have text selected.
Opening paths and URLs
Click a file path printed in the terminal to open it in a tab. If it is
already open, its existing tab is selected. Paths such as src/main.rs:42
are accepted, but jumping to the line is not yet supported. Unicode paths
and paths enclosed in Japanese parentheses are supported, as are names such as
.gitignore and foo.test.dart. Enclose paths containing spaces in quotes or
parentheses, or escape each space with \. Hover over a link to see its clickable
text underlined. Links with a separate display label can also be clicked. A URL starting with
http:// or https:// opens in your default browser.
Dropping files
Drag one or more files from your computer onto the terminal to insert their paths. Spaces and quotes are safely quoted. Nothing is submitted automatically; review the input before pressing Enter. Files are not uploaded when you are connected to another computer.
Adjusting the display
Font size, line height, font, and colour scheme are set under Terminal in Settings.
There are two ways to draw the terminal.
- xterm (default) — the app interprets the terminal and draws it
- Grid (experimental) — the server interprets it and the app draws the result. It survives reconnects better and uses less bandwidth, but it still has open problems
If the display is scrambled, or typed keys do not show up on screen, first put the renderer back to xterm.
On a phone or a tablet
On touch devices, a row of helper keys (Esc, Tab, Ctrl, arrows and so on) sits below the terminal, so that the TUI can be driven through even without a keyboard.
Compose longer instructions
Open the compose sheet from the start of the helper-key row (on a desktop, right-click the terminal and choose Compose). Typing directly into the terminal sends one character at a time and submits on each newline, so write multiple lines here and choose Paste (without Enter) or Send (with Enter).
Save instructions you use often and send them with one tap next time. Saved prompts live on the server, so your Mac and phone show the same list. Long-press one to edit it in the box or delete it.
Use the photo button to attach something: from your photo library on a phone (for example a screenshot), or a file
on a desktop. It is stored on the server's computer in ~/.buster7/uploads, and its path is inserted into the box,
so agents such as Claude Code can read the image from there. It is not placed inside the repository, so it does not
show up in your changes. Files up to 20 MB are accepted, and files older than 7 days are removed when the server starts.
Opening the same session on another device
When the same session is open on more than one device, such as a desktop and a phone, the device that opened it last takes over. The terminal is resized to fit that device.
On the device that had it open before, the display pauses and a bar says the session is being used on another device. While it is paused, typed keys are not sent either. This keeps output drawn for a different screen size from scrambling the display.
To carry on there, press Use on this device. The terminal goes back to that device's size and is redrawn, and the other device pauses instead.