The Archive · Desktop · Guides

Use the terminal

The real terminals of a session — which ones the agent opened, which ones you did, and the keys that move between them.

Checked on Desktop 0.1.19

A newer version is out (Desktop 0.1.25): some details may differ.

The terminal of a session is a real terminal, not a transcript of one. Its tabs are of two kinds, and each says who opened it and where it runs: those the agent launched — with the number of the turn it happened in — and those you open. The footer of a tab repeats it: who launched it, how long it has run, how it ended.

  • Ctrl ` (⌘ ` on a Mac) shows or hides the terminal; Ctrl ⇧ ` opens a new tab.
  • Click a tab to select it; middle-click, or Ctrl and click, to close it.
  • The context menu closes one tab, the others, or all.
  • In the list of tabs: arrows move, Home and End go to the ends, Delete closes, F2 renames.
  • When a tab closes, focus moves to the one that takes its place. The shell’s name stays until you choose one.

A session keeps at most eight tabs.

  • It is not isolated from the rest of your computer. Its label says where it runs; it promises no isolation that does not exist.
  • A command can write files even when the write tool is denied. It is one of the gaps described in Permissions. To close it, restrict the terminal too.
  • No new tab opens — the session already has eight. Close one.
  • A tab seems stuck — its footer says for how long, and in which state.

Type to search the guides.