Working with agent sessions in the GitHub Copilot app

Starting a session

Each session in the GitHub Copilot app runs in its own isolated workspace, so you can run multiple sessions in parallel and make progress on several tasks without conflicts.

1. In the sidebar next to Sessions, click + to start a new session.
2. Choose a repository—you can use a local folder, choose from GitHub, or clone from a URL.
3. From the dropdown under the prompt box, choose where the session should run: in a new working tree, in your local repository, or in a cloud sandbox. Cloud sandboxes for Copilot (public preview) are fully isolated environments hosted by GitHub. For more information, see About cloud and local sandboxes for GitHub Copilot.
4. Select a session mode, model, and reasoning effort from the dropdowns above the prompt field.
5. Describe the task in the prompt field. You can reference issues with #, add files with @, or use / for commands.

The agent starts working. Your active sessions appear in the sidebar grouped by repository—click any session to switch to it.

Choosing a session mode

The session mode controls how much autonomy the agent has. You can set the mode from the dropdown above the prompt field and change it at any time.

• Interactive: You and the agent work together. The agent suggests changes and waits for your input before proceeding.
• Plan: The agent creates a plan first. You review and approve the plan before the agent executes it.
• Autopilot: The agent works fully autonomously—writing code, running tests, and iterating without waiting for input.

Choosing a model

You can select a model and reasoning effort from the dropdowns above the prompt field. Higher reasoning effort gives the agent more time to think through complex problems but may take longer. You can change both settings at any time during a session.

Using quick chats

Quick chats in the sidebar opens a conversation mode without creating a dedicated branch or worktree. Use it for brainstorming, asking questions, or exploring ideas before starting a session. Your chat history is saved and listed by conversation name.

Using /chronicle with app sessions

Because the GitHub Copilot app is built on GitHub Copilot CLI, you can use Copilot CLI session history features such as /chronicle to get insights from work you did in the app and in other Copilot CLI sessions.

For example, you can use /chronicle standup to summarize recent work. For more information, see Using GitHub Copilot CLI session data.

Using voice dictation

You can use voice dictation to speak prompts in a session instead of typing them.

Before you can use voice dictation, you need to configure it in the app settings.

1. Open the app settings, then select the Voice dictation tab.
2. Choose a keyboard shortcut.
3. Allow microphone access in your operating system settings.
4. Download a local transcription model.

After setup, use your shortcut to start and stop voice transcription. The app inserts transcribed text into the prompt box so you can review or edit it before sending.

Using the rubber duck agent

The rubber duck agent is a built-in agent that acts as a constructive critic, reviewing your current plan, implementation, or tests and returning concrete feedback. The agent runs on a different model from the one driving your current session.

When rubber duck is enabled, Copilot can consult it automatically at key points while it works. The main session agent passes work to the rubber duck agent, receives the critique, then decides how to apply that feedback before continuing.

You can also manually ask Copilot to get a review from the rubber duck agent.

1. Open an active session.
2. In the prompt box, type /rubber-duck and ask for a critique of your current plan, implementation, or tests.

For more information on the rubber duck agent, see About the rubber duck agent.

Keyboard shortcuts

The GitHub Copilot app supports keyboard shortcuts to help you navigate sessions, switch between workspaces, and perform common actions. To see available shortcuts, open the app, go to Help, then Keyboard Shortcuts.