detachbox
PagesThe browser terminal

The browser terminal

Close the browser and the terminal keeps running: it is a tmux session in its own fresh Linux environment. Start a job at your desk, check on it from your phone, pick it up in any browser: it is the same session every time.

An agent's terminal opens in its project and sees only that project and the project's own home folder, so another project's logins, keys and settings stay out of its reach. A shell terminal sees every project under /work and has a home folder of its own.

The Terminals page: eight agent terminals across api, storefront and etl-pipeline on the left, two of them needing you, and Claude Code in api moving billing to Stripe webhooks on the right, with the tests passed against Postgres and a pull request opened.

Find your way around Terminals

Terminals holds two columns: the list of every terminal on the left, and the one you picked on the right, with a bar over it. Pick a row to switch; the others keep running. The terminals list explains the rows and their states.

On a phone you see the list first. Tap a row to open that terminal, and the ← button in its bar takes you back to All terminals.

Need more room? ⌘B or Ctrl+B folds the sidebar into a strip of icons and back, and the browser remembers your choice. On a window narrower than 1280 px, Terminals starts with the sidebar folded.

Open a new terminal

Pick New terminal at the top of the list. With the focus outside the terminal, T does the same, and so does New terminal in the ⌘K command menu.

The dialog shows how many terminals run against your size, such as 3 of 5 terminals, and offers four ways in:

  • Launch a terminal: pick a Project, an Agent and what it Runs on, then Launch. Type in any field to find a choice; your 5 most recent projects come first. The dialog remembers your last combination and puts the focus on Launch, so Enter starts it again.
  • Saved launches: every launch of every project, one click each. With 6 or more launches, a search field finds one by project, agent or account.
  • New project…: clone a repository, start empty or import a folder from your home.
  • Open shell: a login shell with your home and all project folders.

Start runs 3 terminals at once, Pro 5, Max 8, Business 10, Business Plus 15, Business Max 20, Business Ultra 30. With every slot taken, the dialog says All terminal slots are in use and offers Change plan. Projects and terminals add nothing to your bill.

While a terminal starts, it lists its steps and how long it has taken so far. On a computer, it receives keyboard focus once ready. If it fails to start, pick Start again.

Use the bar over the terminal

ControlWhat it does
Agent icon, project and nameDouble-click the name to rename the terminal
The account it runs onLists the accounts the agent can use and switches it, as Subscriptions shows
Sallyport mark with a numberThe services the project's agent may call through Vault, and Add access
Files and previewsThe terminal's preview links, shared files and Open file…
RenameThe pencil: names the terminal
DictateEnters a dictated prompt into the terminal; hidden on touch screens, which have it on the key bar, and greyed out with the reason in a browser without speech recognition
Full screenGives the terminal the whole screen; hidden on small screens
Restart terminalStarts it again on the latest image
×Ends the terminal

Rename a terminal

Double-click the name in the bar, or pick the pencil. Type up to 64 characters, then press Enter to save or Esc to keep the old name. The name shows in the list, in the command menu and in every ping about this terminal. A terminal without a name of its own goes by its project.

End a terminal

Pick × in the bar. End terminal …? says what goes: the terminal and the programs running in it, agents included, plus the system tools and Docker cache installed there. Your home and project files stay. Pick End terminal to confirm. The slot frees up at once.

Restart a terminal

A terminal keeps the image it started on. Restart it to put it on the latest one, with the newest agent versions: it starts again in a fresh container, stays the same terminal and attaches by itself once it runs.

  • Over an agent's terminal, pick Restart terminal on this conversation to bring the agent back where it left off, or Restart terminal with a new conversation to start clean. On a phone, one Restart terminal button offers both.
  • Over a shell, pick Restart terminal.
  • Stays: the project's files and its home folder, the agents' conversations with them. Public preview addresses and file links stay; start the server again once the terminal is back. For a file link to work after restart, create it for a file in the project or the terminal’s home folder.
  • Goes: whatever runs in the terminal now, its Docker containers and images, files outside its home folder and projects, its pasted images and uploaded files.

Restart on this conversation works for all three agents: Claude Code and OpenCode continue their last conversation in the project, and Codex resumes its last session.

When the connection drops

The terminal shows "Reconnecting… tmux keeps the session" and comes back by itself. Pick Now to try again at once.

  • "Too many browser connections are open" means other windows hold the terminal's connections: close one and try again.
  • "This terminal has ended" means it is gone; open a new terminal.
  • If the shell in a terminal exits, pick Start a new shell in this terminal.

Terminals you leave stay connected while the dashboard is open. Come back from Settings or Projects and the screen is there as you left it, with nothing to redraw.

A dashboard tab left open across one of our releases reloads itself once to load the new version. Your terminals keep running through it.

When a terminal ends by itself

A terminal with no agent running in it and nobody on it for 3 hours ends by itself and frees its slot. A terminal whose agent runs keeps going, with or without you. Activity records each end.

After a node reboot, every terminal comes back by itself with its packages, Docker images and uploaded files. Programs that were running stop, and the agent comes back on its own conversation by itself, waiting for your next word. If it is not back, Restart terminal on this conversation starts it there again.

A terminal can also stop because your Compute ran out of memory or the terminal ran out of processes. Its notice says which, with Restart terminal right in it: CPU, memory and disk explains both.

Copy text out of the terminal

Select text and copy it with ⌘C or Ctrl+Shift+C. Right-click the terminal for Copy, Paste, Paste as plain text, Select all, Clear and Find. Over a file path or a link, the same menu adds Open file or Open link, and Copy link.

Programs on your Compute can fill your clipboard too. xclip, wl-copy, tmux copy mode and Claude Code's /copy send up to 100 KB of text to your browser, and the terminal confirms with "Copied". That is how a one-time code from gh auth login lands in your clipboard. If the browser wants a click first, the terminal shows the text it got with a Copy button.

To paste images and files, see Files, screenshots and photos. Every key the terminal answers to is on Keyboard shortcuts.

Find in the scrollback

Press ⌘F or Ctrl+Shift+F. Type to search; the field counts matches as "2 of 9". Press Enter for the next match and Shift+Enter for the previous one, and Esc to close.

The browser keeps the last 5,000 lines of each terminal. tmux keeps 50,000 lines of history: scroll up with the mouse wheel or by dragging on a phone. Cyrillic, CJK and emoji keep their widths, so tables and progress bars line up.

Handle pages the agent opens

When an agent runs detachbox-open, xdg-open or $BROWSER, the dashboard shows "The agent opens a page:" with the page's whole address. Pick Open. A page asked for twice within a few seconds opens once.

For one of the terminal's previews, the prompt offers Open previews automatically from now on: tick it before you open the page, and the next previews open by themselves. Change your mind any time under Settings → Terminal → Pages the agent opens: switch Open previews in this browser by themselves on, and each preview opens in a new tab at once; switch it off, and each preview waits for your click in the terminal. A page on another site offers to always allow its exact host, named on the button. The choice holds for your Compute in this browser. If the browser blocks the pop-up, the dashboard says so once: allow pop-ups for my.detachbox.com.

A link to your Compute's own localhost:<port> opens as its preview URL.

Pick a theme and text size

The dashboard follows System, Light or Dark, set under Settings → Appearance. Agents draw their screens for a dark terminal, so Terminal stays dark is on by default. Switch it off for a light terminal on the light theme.

Text size runs from 9 to 24 px and is shared by every terminal in this browser: 13 by default, 12 on a phone. Change it with ⌘+, ⌘− and ⌘0 on a Mac, from the ⌘K command menu, or with a two-finger pinch on a phone.