VCode home

Close and reopen a tab

Agents: claude, codex, opencode · On: phone, desktop

Closing a tab stops its agent and takes it out of the strip. The conversation stays on disk, and Recently closed brings it back. A tab with nothing in it closes without asking and is deleted, so it never shows in Recently closed.

Why you would use it

You finish a piece of work and want the strip back to the tabs you are actually using, without losing what was said. Later you want that conversation back.

How to use it

To close:

The phone's tab strip, with a close cross on every tab.

The desktop tab strip, with a close cross on every tab.

Each close asks first. A popup (#confirm) reads Close this tab? and Tab '<name>' can be resumed later from the ⟲ button., where ⟲ is the clock icon of Recently closed (#recent-open), drawn inline. On a tab with a turn in flight it reads Tab '<name>' is working, and its turn stops. It can be resumed later from the ⟲ button. Tap Close (#confirm-go, on the left), or press Enter or Space (the popup opens with Close focused), to close the tab. Cancel (#confirm-cancel), the cross at its top right (#confirm-x), Escape, the back button or a tap outside it keeps the tab. Tick Do not ask again (#confirm-tick-box) before Close to stop the popup; this turns off Ask before closing a tab in Settings.

The popup over the Threads sheet: Close this tab?, Tab 'report view' can be resumed later from the button with the clock icon, the Do not ask again box, Close and Cancel.

With Ask before closing a tab off, a tab closes on the first press. A tab with a turn in flight, or with background agents still running, then asks twice. The first press turns its cross red and holds it up for three seconds; its tooltip reads Close <name>? The running turn stops. A second press on the same tab closes it. Anything else (three seconds passing, or a press on another tab) puts the cross back.

/exit and an agent's v-code tab close never ask.

An empty tab never asks either: no message sent, no reply, no tool card, plan or side question, nothing queued and no turn running. A system row, such as a model change, does not count. Closing one from the app, by any of the ways above or /exit, deletes it instead of keeping it, so it does not appear in Recently closed. An agent's v-code tab close keeps an empty tab like any other.

To reopen:

  1. Tap the history icon (#recent-open) in the top bar, left of the report button. Recently closed (#closed-pop) opens in the middle of the screen: a search box (#closed-q, Search closed tabs) with your closed tabs listed under it, newest first, from every box on your account.
  2. Type to narrow the list. Each word must appear in the tab's name, its folder or its box.
  3. Tap a tab, or move to it with the arrow keys and press Enter. It comes back with its whole log, in the project it was started in, and you land on it. When that project has been removed, the tab comes back in Worktop.

Ctrl+Shift+T (⌘⇧T on a Mac) reopens the newest closed tab without the popup, in the installed app and the desktop app. With nothing closed it says No closed tabs. A browser tab keeps the key for itself.

All sessions… (#closed-all) opens the resume screen, which finds closed tabs too, with every terminal session on the box. Ctrl+O (⌘O on a Mac) and /resume open it directly.

Recently closed on a phone: the search box with the closed tab report view under it, closed just now.

Recently closed on a wide screen, over the tab in front.

What you see

Closing takes the tab out of the strip at once: it folds away where it stood and the tabs beside it close the gap. Closing the tab you are in moves you to another tab of the same project, and the selection slides over to it. With none left in the project, you land on its end page:

In Recently closed each tab is drawn as it was in the strip: the agent's mark, the tab's name, and its folder or project with its box. In place of the cross it shows how long ago it was closed (just now, 5m ago, 2h ago, 3d ago). The first row is picked; with no match the list reads No closed tab matches. Escape, the back button, the cross (#closed-pop-x) or a tap outside it closes the popup.

Options and settings

Option Default What it changes
Ask before closing a tab (#tabs-confirm-close, Settings, Tabs) On The popup before each close. Off: a tab closes on the first press, and a running tab asks twice
/exit, /quit Closes the tab you are in

Limits and known gaps