Skip to content

Managing sessions

Browse, resume, rename, compact, and export the conversation threads your work runs on.

Press Ctrl+B to open the session browser. It lists every session for the current runtime with a preview, a relative timestamp, the active agent, and badges for anything that needs your attention.

The session browser showing four sessions with previews, relative timestamps, agent names, and message counts. The current session is marked [active].

Sessions are attached to a runtime, not a specific sandbox instance. Resetting the sandbox does not erase the session — the transcript and metadata survive. That’s why “continue yesterday’s work” is a reliable workflow.

Status badges surface state the sidebar can’t otherwise show:

BadgeMeaning
activeThe session you’re currently on
runningAgent is working right now (a background session keeps going)
approvalA permission prompt is waiting for you
inputThe agent is waiting on text input
failedThe last turn errored
N unreadEvents landed while you were on a different session
N queuedMessages you typed that the agent hasn’t gotten to yet
staleReconnect state needs replay

Use the browser to:

  • pick up an older thread — / to highlight, Enter to open
  • start a fresh one — press n
  • delete a session you no longer want — press d
  • find a specific thread — type to search across title, preview, agent, and session ID

The browser never steals focus. A background session that needs input shows approval or input in its row and waits for you to switch into it.

Most session management is a slash command away:

CommandEffect
/newStart a fresh session with the current agent
/reset (/clear)Wipe the current session’s transcript and keep going
/rename <title>Give the session a recognizable title
/export [filename]Write the transcript to session-<id>.md (or the filename you pass)
/compact [guidance]Summarize older history to shrink context before continuing
/sessionsOpen the browser (same as Ctrl+B)

The auto-derived title is usually the first user message, truncated. Rename once the thread has a direction so you can find it later.

As the transcript grows, you’ll start bumping against the model’s context window. /compact asks the agent to summarize older turns into a single message and keeps going on the same session.

/compact focus on what we've tried and what worked

Compaction is non-destructive — older messages are marked compacted rather than deleted, and the session keeps its runtime attachment. Nothing downstream breaks. See Compaction for how to shape the summary.

Messages you type during a turn travel with the session — switch threads and they stay waiting, not lost. For how the queue behaves in the composer, see Conversation.