Manage agent sessions in VS Code

Use the sessions list to return to an agent task, monitor ongoing work, and put completed work away. This article shows how to manage sessions in the Chat view and the Agents window.

A session groups the workspace, code changes, and conversations for a task. Each conversation has its own history and context. If you're starting your first task, follow the agents quickstart.

Find and resume a session

Open an existing session to continue its conversation rather than start the task again.

1. Open the sessions list in the interface you use:

   Interface	Location and scope
   Chat view	The list is at the top of the view and shows sessions for the current workspace, grouped by time. With no workspace open, it shows sessions across workspaces.
   Agents window	The list is in the left sidebar and shows sessions across workspaces. Sessions are grouped by workspace by default.

2. Select the session to open its conversation.

3. If your session is completed, it may not appear in the active sessions list. Change the list filter from active sessions to Archived (Chat view) or Done (Agents window).

4. Review the previous messages and changes before sending a follow-up. For an archived session, restore it first.

If the list isn't visible in the Chat view, right-click in an empty chat and select Show Sessions. For display options, see sessions list layout.

Find a missing session

Check these items before creating a replacement session:

• Workspace and host: Open the original workspace or connect to the host where the session runs. The Agents window lets you browse across workspaces.
• State filters: Include Archived or Done sessions, not only active sessions.
• Other applications: Check the External filter and discovery limits.
• Supported interface: Local harness sessions and sessions from the OpenAI Codex extension are editor-only. Check which sessions support both interfaces.

To find earlier work by topic, file, or pull request instead of browsing the list, query session history. Synced history doesn't by itself provide access to a running agent.

Continue between the Chat view and Agents window

Supported Copilot and Claude sessions are available in both interfaces. Codex requires the experimental Agent Host integration. Switching interfaces doesn't change the session's harness, workspace, or worktree.

For a Copilot session with a project:

• From the Agents window: Select Open in Editor in the title bar. The editor opens the project with the session available in the Chat view.
• From the Chat view: Select Open in Agents in the application title bar, then select the existing session from the sessions list.

To change the harness instead, see Continue with a different harness.

View sessions from other applications

You can open supported local sessions from Copilot CLI, the GitHub Copilot app, Claude Code, and Codex in either interface.

Open the sessions list filter and select External to choose which discovered sessions appear:

The filter applies to both interfaces and is also configurable with chat.agentSessions.showExternal Open in VS Code Open in VS Code Insiders (Experimental). Discovery has separate limits: Copilot only considers supported local sessions updated within the last seven days, even if you select Last 30 Days.

When you open an external session in the Agents window, a one-time banner identifies its origin and lets you choose which external sessions to show. If that choice hides the open session, you're asked to confirm it. After you send a message from VS Code, the session is no longer external and the External filter no longer controls its visibility.

For an external Codex session, only one application can write to the chat at a time. If This chat is open in another app appears, fully quit the other application and select Retry. The transcript, draft, and attachments remain available while sending, queueing, and resending are blocked. Retry doesn't send the draft. Send it yourself after the banner disappears.

Use Copilot CLI from the terminal

If the session's context menu includes Resume in Terminal, select it to continue in GitHub Copilot CLI. Not every harness or session type provides this action. Otherwise, continue in a supported VS Code interface.

To begin a separate terminal conversation, start a new CLI session. Starting a new CLI session doesn't resume an existing conversation.

Continue on another device or in the cloud

To move from local work to cloud execution, start a separate cloud session.

For a hands-on walkthrough, start a task in a cloud session and continue it from a regular terminal with Copilot CLI Cloud sessions is experimental and might change or be removed. .

Start a new or related conversation

Choose a conversation based on whether you need the discussion so far:

Start an agent session

For an independent task, follow the steps to start a session in the Chat view beside your editor, or in the Agents window across workspaces. Choose the workspace, harness, and code isolation before sending the first prompt.

On Windows, you can also open the Agents window by right-clicking the VS Code taskbar icon and selecting Agents Window.

Run multiple chats in a session

A nested session is a separate, interactive conversation grouped under an existing session. It starts blank, without the other chats' history, and uses the parent's harness and host. The harness must support multiple chats, and the parent session must not be archived.

With a harness that provides session-management tools, ask the agent to start a separate chat within the ongoing session. This works in both the Chat view and the Agents window. For example:

Start a separate chat within this session to review the authentication flow. Reuse the current workspace and do not modify files.

Alternatively, use the controls in the Agents window:

1. Hover over the parent session and select + (New Nested Session), use its context menu, or press ⌘T (Windows, Linux Ctrl+T) while the session has focus.

2. Choose the working folder above the input:

   • Keep the preselected folder to share the parent's folder or worktree.
   • Select a recent folder or Open Folder... to use another folder.
   • Select No Workspace for a separate temporary folder. This is preselected for quick chats. Temporary files aren't shared between workspace-less chats.

   Harnesses supporting only one folder limit the choice to the parent's folder, or No Workspace for a quick chat.

3. For a Git folder, select Branch to work directly in the folder, or New Worktree and a base branch to isolate changes. Plain folders and No Workspace don't offer these controls.

4. Enter a prompt and press Enter. The nested session appears beneath its parent in the list.

Each chat has its own title, history, and agent or model selection. For a hands-on workflow with isolated changes, follow Delegate two tasks without mixing their changes.

Fork a chat session

A fork retains the source conversation's history so you can explore an alternative without losing the original discussion. Type /fork to copy the full conversation, or hover over an earlier request and select Fork Conversation to include only the requests through that checkpoint.

In multi-chat Copilot sessions in the Agents window, the fork opens as a nested session. In single-chat sessions and harnesses without multiple-chat support, it opens as a separate session. A Copilot worktree session's fork uses the original worktree, so forking doesn't isolate code changes.

Supported Agent Host sessions, such as Copilot, also accept these forms in either interface:

For example:

/fork prompt Compare this design with an event-driven approach. Do not change any files.

A prompted fork uses the source conversation's agent and model, not new input-picker selections. An explicit title is retained. Otherwise, the fork can receive an automatically generated title based on the original title and new prompt.

Ask side questions

When asking about a specific part of a response, choose whether to keep the follow-up in the current conversation or start a side chat. Side chats are available in supported Copilot and Claude sessions in both interfaces.

In either interface, you can also type /btw <question> to start a side chat from the latest turn, including a response in progress, without selecting a fragment.

A side chat inherits the source conversation's agent, model, and context through the source turn. Inherited messages aren't shown in its transcript. The question and answer stay in the side chat rather than the source conversation. Side chats favor explanation unless you ask for changes or actions.

Side chats aren't available for Local harness sessions or sessions from the OpenAI Codex extension.

Monitor progress and switch conversations

Use the sessions list to check session status, harness, and file changes. Select a session to inspect its response or provide input. Before integrating its work, review the code edits and validate the result.

For sessions with multiple chats, progress and unread indicators belong to each chat. The session remains in progress while any chat is working, and the session header Changes pill combines their edits.

For optional ways to keep track of work, configure application icon badges (Preview), the title-bar status indicator (Experimental), or the sessions welcome page.

To have an agent create sessions, read another conversation's context, or send follow-up messages, see Coordinate work across sessions with tools.

Keep long conversations focused

The context window control in the chat input shows how much context the active chat uses. Hover over it for token counts, a category breakdown, and the session's total AI credits. Available context depends on the model.

Compact conversation context

Compaction summarizes earlier history to free context space and reduce tokens sent with subsequent requests. Conversations compact automatically when the context window fills. To turn this off, set github.copilot.chat.summarizeAgentConversationHistory.enabled Open in VS Code Open in VS Code Insiders to false.

For manual compaction in Local, Copilot, or Claude sessions:

• Type /compact, optionally adding what to retain, such as /compact focus on the database schema decisions.
• Select the context window control, then Compact Conversation.

For a fresh conversation instead of a summary, start a nested session or a new session. Neither clears saved files, custom instructions, or persistent memory. To undo code changes, review and revert them.

Stable context and forks can preserve prompt caching to reduce cost and latency. Learn about AI credit usage and use the Cache Explorer to investigate cache hits.

Organize sessions

Hover over a session to pin it at the top of the list. Right-click it for additional actions, which depend on its harness and state. In the Agents window, you can also group sessions by workspace or timeframe and collapse group headers.

Create a custom group

In the Agents window, group related top-level sessions and quick chats, including work across projects:

1. Right-click a session, quick chat, or empty area of the list and select Create Group.
2. Enter a name and press Enter.
3. Right-click another session and select Add to Group > your group, or Move to Group if it already belongs to one.

You can also drag multiple selected sessions into a group. Create subgroups with Create Subgroup, or drag a group into another group. Drag sessions and group or workspace headers to reorder them, or drop a session on Pinned to pin it.

Hover over a group header to start a session in that group or mark its sessions as done. Custom groups organize top-level sessions, not individual nested sessions.

To distinguish groups visually, set a custom group icon and color.

Move chats between sessions (Experimental)

Enable chat.agentHost.moveChats.enabled Open in VS Code Open in VS Code Insiders in the Agents window to reorganize conversations. It is on by default in Insiders.

Reorder nested sessions: Select Filter Sessions > Ordering > Created to retain a manual order. Drag a nested session above or below a sibling, or use Move Up and Move Down in its context menu. With the row focused, use ⇧⌥↑ (Windows, Linux Shift+Alt+Up) or ⇧⌥↓ (Windows, Linux Shift+Alt+Down). Available commands depend on the row's position, and the order persists after reopening the window.

Move or promote a conversation:

• Drop a nested session on another session to append it, or on the top or bottom half of a nested row to insert it there. Hover over a collapsed destination to expand it.
• Select Promote to Session from a nested session's context menu, or drag it to empty space below the list or a section header. Send at least one prompt before promoting it.
• Drag a top-level session containing only one chat onto the center of another session, or above or below one of its nested rows, to nest it.

Source and destination must use the same harness and host, the destination must support multiple chats, and neither session can be archived. In Pinned and custom groups, dropping near a top-level row's top edge can reorder it instead of nesting it. An insertion line indicates reordering, and a highlighted destination indicates nesting.

Promotion inherits the parent's custom group, but not its pinned state. A workspace-less conversation promoted to a top-level session appears in Chats.

Moves don't ask for confirmation. A notice shows progress and the result. Select Undo within 10 seconds to restore the previous parent and position. A streaming response continues after a move. Linked subagent conversations, pull requests, and agent merge monitoring stay with the conversation, including after undo.

To change working files rather than grouping, move the chat to another folder or worktree.

Finish and restore sessions

Choose the action that matches what you want to keep:

Archive sessions

1. Hover over the session and select Archive (Chat view) or Mark as Done (Agents window).

2. To find it later, select the Archived or Done list filter.

3. To continue, right-click the session and select Unarchive (Chat view) or Restore (Agents window).

For a worktree session, archiving commits uncommitted changes to the session branch before removing the worktree folder. If changes can't be preserved or the folder can't be removed, the worktree remains. The branch and commits are retained, so restoring re-creates the worktree.

For a Dev Container session, marking done removes the container without waiting for idle shutdown, but only if no other session or unsent draft uses it. Restoring starts a replacement container and retains the conversation.

Mark an individual chat as done

In the Agents window, expand the parent session, right-click an additional chat, and select Mark as Done. This hides it from the active list and closes its tab without affecting the parent or other chats. Its title and transcript are preserved after reload.

To restore it, select the global Done filter or right-click the parent and select Show Done Chats. Right-click the done chat and select Restore.

Main chats, side chats, and subagent chats can't be marked done independently.

Delete sessions

Right-click a session and select Delete. For Copilot harness sessions, this also removes associated worktrees created for the session. A shared worktree remains while another session still uses it and is removed only after the last linked session is deleted or archived.

For Dev Container sessions, deletion removes the container only when no other session or unsent draft uses it, even if automatic idle shutdown is off.

To delete an individual chat in the Agents window Multiple presentation, select Delete Chat in its tab's context menu, or press ⌘Backspace (Windows, Linux Delete) while it has focus.

Clean up session worktrees

Run Chat: Open Worktree Cleanup to reclaim disk space from inactive session worktrees.

1. Choose an inactivity period of 7, 15, 30, 60, or 90 days.
2. Review estimated worktree sizes and clear any selected worktrees you want to keep. Eligible worktrees are selected by default.
3. Save open file edits in the selected worktrees, then confirm cleanup.

Cleanup marks the sessions done and schedules their worktrees for removal. As with manual archiving, it commits uncommitted changes first and retains the session and branch history for restoration. If preservation or removal fails, the worktree remains.

The editor excludes sessions that are active, running, waiting for input, pinned, done, archived, untitled, in error, or newer than the inactivity threshold. Worktrees whose size can't be measured are also excluded.

Open Cleanup Settings to configure automatic completion, deletion retention, or storage suggestions.

Storage suggestions (Experimental): Enable chat.agentSessions.sessionStorageCleanupSuggestion.enabled Open in VS Code Open in VS Code Insiders for a suggestion in the Agents window when inactive worktrees use at least 5 GiB or 20 worktrees qualify. Selecting it opens the cleanup editor. Dismiss it for the current window, or select Don't Show Again or run Chat: Disable Session Storage Cleanup Suggestions to turn it off.

Automatically clean up merged sessions

For Copilot, Claude, and the experimental Codex integration, configure two separate inactivity periods. Both default to 0 (off). Use positive whole numbers of days, with 15 recommended:

• chat.agentSessions.autoMarkAsDoneMergedSessionsAfterDays Open in VS Code Open in VS Code Insiders : Days before an eligible session is automatically marked done.
• chat.agentSessions.autoDeleteMarkedAsDoneMergedSessionsAfterDays Open in VS Code Open in VS Code Insiders : Grace period after automatic completion before permanent deletion.

Eligible sessions aren't in progress, exceed the inactivity threshold, have at least one merged pull request, and have no related open pull requests. External sessions aren't eligible. Checks run at startup and hourly while either setting is on.

Only automatically completed sessions qualify for automatic deletion. Manually completed sessions don't qualify. Restoring an automatically completed session clears its deletion eligibility.

Unlike manual archiving, automatic cleanup removes a worktree only if its branch tracks an upstream and has no outgoing commits or uncommitted changes. Unknown Git state or unmet conditions retain the worktree. It is never force-removed.

When a merged pull request makes a session eligible, Configure Automatic Cleanup in the Mark as Done suggestion opens both settings without turning them on.

To retain or share conversation content separately, export a chat as JSON or copy messages as Markdown. Review the contents before sharing.

Move a chat to another folder or worktree

In the Agents window, continue a task in another folder or a new worktree without losing its conversation history. This requires a single-chat Agent Host session with one local folder. Use the Copilot harness, or Codex (Experimental) in Interactive mode.

Ask the agent to move the chat. There isn't a separate move button:

Move this chat to <absolute folder path> and continue the current task there.

The destination must be on the same host. To isolate implementation before making changes, request a new worktree instead:

Continue this task in a new Git worktree of the current repository before implementing it.

Confirm the destination and whether to use it directly or create a worktree. Review tool approvals and Workspace Trust requests. The agent finishes its turn and moves the chat. Wait for the workspace-change notice and automatic continuation before sending more prompts.

A folder move uses the destination's existing files, without moving or copying the original files. A new worktree starts from committed Git state and requires at least one commit. Uncommitted changes stay in the original folder, except files copied by configured worktree include rules. See code isolation prerequisites and file-copy behavior.

Related resources

• Understand sessions and chats
• Use chat to send and steer requests
• Delegate two tasks without mixing their changes