VCode home

Find and resume any session

Agents: claude, codex, opencode, cursor, devin, copilot, muse · On: phone, desktop

The resume screen finds any session on this box by what was said in it. An open tab, a closed tab and a claude or codex session you started in a plain terminal are rows of one list. Pick one to go back to it, or fork it into a new tab.

Why you would use it

You remember the conversation, not the tab. Maybe you closed it last week, or you started it at the desk in a terminal you cannot reach from the phone. Type a few words you remember and the session comes up, with its last turns beside it.

How to use it

  1. Open the resume screen (#resume) any of these ways:

    • type /resume (or /sessions) in the composer (#draft) and send it
    • press Ctrl+O (⌘O on a Mac)
    • tap Resume… (#sessions-resume) in the head of the Threads sheet
  2. Type in the search box (#resume-q, search sessions…). The list (#resume-rows) follows as you type. Every word must appear in the session's title or in what was said; case does not matter.

  3. Tap the scope chip (#resume-scope) to change where it looks. In a project it starts on This project, then This folder (the folder of the tab you are in) and This box. In Worktop it starts on This box.

  4. Tap a row to select it. Its last turns show in the preview (#resume-preview): below the list on a phone, beside it on a wide window. With a keyboard, the up and down arrows move the selection.

    The resume screen on a phone: the search box reading "csv export" with the This box chip, three rows with the words marked in each, and the selected session's last turns docked below with the Reopen and Fork buttons.

  5. Tap Reopen (#resume-open), tap the selected row again, or press Enter.

    • An open tab: the button reads Open, and you switch to that tab.
    • A closed tab: it comes back with its whole log, in the project it was started in.
    • A session started in a terminal: its transcript is imported into a new tab in the active project, and your next message continues that session.
  6. Or tap Fork (#resume-fork). A new tab opens in the active project on a copy of the session. The agent keeps the whole context, and the session you forked from stays as it was.

    With either button, if you opened the screen on an empty tab, one where nothing has been said yet, the session takes its place: the empty tab closes once the session is open.

    The resume screen on a wide window: the list on the left and the selected session's preview on the right, with Reopen and Fork under it.

  7. Tap the cross (#resume-close), press Escape or press the phone's back button to close the screen without picking anything.

What you see

Each row has the agent's mark, the title, one line from the session and the time on the right. The title is the tab's name when a tab holds the session, else the first thing you typed in it. The line is the agent's last reply; with a search it is the part of the newest message that matches, with your words marked and … where it was cut. The time is the clock for today, the weekday for the last six days, Oct 3 for earlier this year, else the full date.

A row whose folder is not the project's main folder carries the folder as a tag: the path below the main folder for a worktree, else the whole path.

The preview starts with a line of <agent> · <folder> · N turns, under the title on a wide window, then the last turns, each tagged as in the transcript: what you typed under You, each reply under the agent's mark and name with the model that wrote it (for example Claude Opus 5.5), and each tool call as its tag and what it did (Bash npm test).

Until the box answers, the list reads searching…. While the box builds its index for the first time, the end of the list reads indexing… N files and the list fills in as it goes. With no match it reads no sessions match.

Fork shows forking claude session…, then forked · 132 of 410 items. Reopen on a terminal session shows resuming claude session…, then resumed · 132 of 410 items. The new tab opens with a system note: resumed claude session a1b2c3d4, showing the last 132 of 410 items; the agent still has the full session, or for a fork forked from claude session a1b2c3d4, showing the last 132 of 410 items. When nothing was left out it ends : 132 items imported.

Limits and known gaps