{"meta":{"title":"Using Copilot cloud agent in your IDE","intro":"Start and track Copilot cloud agent sessions from Visual Studio Code, JetBrains IDEs, Eclipse, and Visual Studio.","product":"GitHub Copilot","breadcrumbs":[{"href":"/en/copilot","title":"GitHub Copilot"},{"href":"/en/copilot/how-tos","title":"How-tos"},{"href":"/en/copilot/how-tos/use-copilot-agents","title":"Use Copilot agents"},{"href":"/en/copilot/how-tos/use-copilot-agents/cloud-agent","title":"Cloud agent"},{"href":"/en/copilot/how-tos/use-copilot-agents/cloud-agent/use-cloud-agent-in-your-ide","title":"Use cloud agent in your IDE"}],"documentType":"article"},"body":"# Using Copilot cloud agent in your IDE\n\nStart and track Copilot cloud agent sessions from Visual Studio Code, JetBrains IDEs, Eclipse, and Visual Studio.\n\n<div class=\"ghd-tool vscode\">\n\n## Starting a session\n\n1. Install the [GitHub Pull Requests extension](https://marketplace.visualstudio.com/items?itemName=GitHub.vscode-pull-request-github) for Visual Studio Code.\n\n2. Open GitHub Copilot Chat in Visual Studio Code.\n\n3. Type a prompt explaining what you want Copilot to do.\n\n   For example, `Put backticks around file names and variables in output`\n\n   > \\[!TIP]\n   > To help Copilot, you can select the relevant line(s) of code before submitting your prompt.\n\n4. Submit your prompt by clicking the <svg class=\"octicon\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" xmlns=\"http://www.w3.org/2000/svg\" fill=\"currentColor\"><path d=\"M15.724 11.053V11.948L7.724 15.948L7.026 15.343L8.14 12.001H13V11.001H8.14L7.026 7.659L7.724 7.054L15.724 11.053ZM1 8C1 6.46 2.15 5.18 3.67 5.02L4.02 4.98L4.11 4.64C4.5 3.09 5.89 2 7.5 2C9.43 2 11 3.57 11 5.5V6H11.5C12.88 6 14 7.12 14 8.5V8.52L14.95 8.99C14.98 8.83 15 8.67 15 8.5C15 6.73 13.68 5.26 11.98 5.03C11.74 2.77 9.82 1 7.5 1C5.55 1 3.84 2.25 3.23 4.07C1.37 4.43 0 6.07 0 8C0 10.21 1.79 12 4 12H7V11H4C2.35 11 1 9.65 1 8Z\"/></svg> **Delegate this task to the GitHub Copilot cloud agent** button, next to the <svg class=\"octicon\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" xmlns=\"http://www.w3.org/2000/svg\" fill=\"currentColor\"><path d=\"M1 1.91L1.78 1.5L15 7.44899V8.3999L1.78 14.33L1 13.91L2.58311 8L1 1.91ZM3.6118 8.5L2.33037 13.1295L13.5 7.8999L2.33037 2.83859L3.6118 7.43874L9 7.5V8.5H3.6118Z\"/></svg> **Send** button\n\n5. If you have local changes, a dialog will be displayed asking if you want to push those changes so Copilot can start from your current state. Click **Include changes** to push your changes, or **Ignore changes** to ask Copilot to start its work from your repository's default branch.\n\n   Copilot will start a new session and respond with a link to the pull request it creates. It will work on the task and push changes to the pull request, and then add you as a reviewer when it has finished, triggering a notification.\n\n## Tracking your sessions\n\nYou can see a list of your running and past agent sessions for a specific repository in Visual Studio Code with the [GitHub Pull Requests extension](https://marketplace.visualstudio.com/items?itemName=GitHub.vscode-pull-request-github).\n\nOnce you've installed the extension, you can see Copilot's sessions by clicking the **GitHub** button in the sidebar.\n\nFor each session listed, you can see its status at a glance, or click on it to navigate to the pull request within Visual Studio Code.\n\nTo view the session logs, click on the pull request in the list, then click **View Session**.\n\nTo directly open agent sessions in VS Code, click the **Open in VS Code** option on the agents tab.\n\n> \\[!NOTE]\n> Opening a session in VS Code is currently only available in VS Code Insiders.\n\n</div>\n\n<!-- --------------------- -->\n\n<!-- JetBrains -->\n\n<!-- --------------------- -->\n\n<div class=\"ghd-tool jetbrains\">\n\n> \\[!NOTE]\n> Copilot cloud agent in JetBrains IDEs is in public preview, and subject to change.\n\n## Starting a session\n\n1. Enable Copilot cloud agent in your JetBrains IDE.\n   1. Open **Settings**.\n   2. In the sidebar, click **Tools**, then **Copilot**, then **Chat**.\n   3. Select **Enable Cloud Agent**.\n\n2. If you use Copilot Business or Copilot Enterprise, ask your administrator to enable the Editor preview features policy.\n\n3. Open Copilot Chat in your JetBrains IDE.\n\n4. Type a prompt explaining what you want Copilot to do.\n\n   For example, `Put backticks around file names and variables in output`\n\n5. Click the **Delegate to Cloud Agent** button next to the **Send** button.\n\n   Copilot will start a new session and respond with a link to the pull request it creates. It will work on the task and push changes to the pull request, and then add you as a reviewer when it has finished, triggering a notification from GitHub and in the IDE.\n\n## Tracking your sessions\n\nYou can see a list of your running and past agent sessions for a project in JetBrains IDEs with the Copilot Chat extension. See [Installing the GitHub Copilot extension in your environment](/en/copilot/how-tos/set-up/install-copilot-extension?tool=jetbrains).\n\nCloud agent sessions appear in the unified sessions view in the Copilot Chat panel alongside local and Copilot CLI sessions.\n\nYou can open the unified sessions view by clicking the **GitHub Cloud Agent Jobs** button in the sidebar or by clicking the **Open Job List** button after delegating a task to Copilot from Copilot Chat.\n\nYou can filter sessions by agent type or status to find the session you want.\n\nFor each session listed, you can see its status at a glance. Click **Open in Browser** to open the pull request in your browser, or right-click on a running job then click **Cancel Job** to cancel.\n\nCopilot will also notify you when an agent job has started and finished.\n\n</div>\n\n<!-- --------------------- -->\n\n<!-- Eclipse -->\n\n<!-- --------------------- -->\n\n<div class=\"ghd-tool eclipse\">\n\n> \\[!NOTE]\n> Copilot cloud agent in Eclipse is in public preview, and subject to change.\n\n## Starting a session\n\n1. Open GitHub Copilot Chat in Eclipse.\n\n2. Type a prompt explaining what you want Copilot to do.\n\n   For example, `Put backticks around file names and variables in output`\n\n3. Click **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-agent\" aria-label=\"The Agents icon\" role=\"img\"><path d=\"M14.5 8.9v-.052A2.956 2.956 0 0 0 11.542 5.9a.815.815 0 0 1-.751-.501l-.145-.348A3.496 3.496 0 0 0 7.421 2.9h-.206a3.754 3.754 0 0 0-3.736 4.118l.011.121a.822.822 0 0 1-.619.879A1.81 1.81 0 0 0 1.5 9.773v.14c0 1.097.89 1.987 1.987 1.987H4.5a.75.75 0 0 1 0 1.5H3.487A3.487 3.487 0 0 1 0 9.913v-.14C0 8.449.785 7.274 1.963 6.75A5.253 5.253 0 0 1 7.215 1.4h.206a4.992 4.992 0 0 1 4.586 3.024A4.455 4.455 0 0 1 16 8.848V8.9a.75.75 0 0 1-1.5 0Z\"></path><path d=\"m8.38 7.67 2.25 2.25a.749.749 0 0 1 0 1.061L8.38 13.23a.749.749 0 1 1-1.06-1.06l1.719-1.72L7.32 8.731A.75.75 0 0 1 8.38 7.67ZM15 13.45h-3a.75.75 0 0 1 0-1.5h3a.75.75 0 0 1 0 1.5Z\"></path></svg>** next to the **Send** button.\n\n4. In the dialog box that opens, select the repository you want Copilot to work in, then click **Continue**.\n\n   Copilot will start a new session and respond with a link to the pull request it creates. It will work on the task and push changes to the pull request, and then add you as a reviewer when it has finished, triggering a notification from GitHub and in the IDE.\n\n## Tracking your sessions\n\nYou can see a list of your running and past agent sessions for a project in Eclipse with the GitHub Copilot Chat extension. See [Installing the GitHub Copilot extension in your environment](/en/copilot/how-tos/set-up/install-copilot-extension?tool=eclipse).\n\nYou can see all of Copilot's sessions by clicking **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-agent\" aria-label=\"The Agents icon\" role=\"img\"><path d=\"M14.5 8.9v-.052A2.956 2.956 0 0 0 11.542 5.9a.815.815 0 0 1-.751-.501l-.145-.348A3.496 3.496 0 0 0 7.421 2.9h-.206a3.754 3.754 0 0 0-3.736 4.118l.011.121a.822.822 0 0 1-.619.879A1.81 1.81 0 0 0 1.5 9.773v.14c0 1.097.89 1.987 1.987 1.987H4.5a.75.75 0 0 1 0 1.5H3.487A3.487 3.487 0 0 1 0 9.913v-.14C0 8.449.785 7.274 1.963 6.75A5.253 5.253 0 0 1 7.215 1.4h.206a4.992 4.992 0 0 1 4.586 3.024A4.455 4.455 0 0 1 16 8.848V8.9a.75.75 0 0 1-1.5 0Z\"></path><path d=\"m8.38 7.67 2.25 2.25a.749.749 0 0 1 0 1.061L8.38 13.23a.749.749 0 1 1-1.06-1.06l1.719-1.72L7.32 8.731A.75.75 0 0 1 8.38 7.67ZM15 13.45h-3a.75.75 0 0 1 0-1.5h3a.75.75 0 0 1 0 1.5Z\"></path></svg>** at the top right of the chat window, or by clicking the **Open Job List** button after delegating a task to Copilot from GitHub Copilot Chat.\n\nFor each session listed, you can see its status at a glance. Click **Open in Browser** to open the pull request in your browser, or right-click on a running job then click **Cancel Job** to cancel.\n\nCopilot will also notify you when an agent job has started and finished.\n\n</div>\n\n<!-- --------------------- -->\n\n<!-- Visual Studio -->\n\n<!-- --------------------- -->\n\n<div class=\"ghd-tool visualstudio\">\n\n> \\[!NOTE] To use Copilot cloud agent in Visual Studio, you'll need to be running at least [December Update 18.1.0](https://learn.microsoft.com/en-us/visualstudio/releases/2026/release-notes#github-copilot-1) of Visual Studio 2026.\n\n## Starting a session\n\n1. Enable Copilot cloud agent support in Visual Studio.\n   1. Open the **Tools** menu, then click **Options**.\n   2. In the sidebar, select **GitHub**.\n   3. Check the **Enable Copilot Cloud agent (preview)** box.\n   4. Restart Visual Studio.\n\n2. Open GitHub Copilot Chat in Visual Studio.\n\n3. Enter a prompt, giving details of what you want Copilot to change.\n\n   For example, `Put backticks around file names and variables in log output.`\n\n4. Submit your prompt by clicking the <svg class=\"octicon\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" xmlns=\"http://www.w3.org/2000/svg\" fill=\"currentColor\"><path d=\"M15.724 11.053V11.948L7.724 15.948L7.026 15.343L8.14 12.001H13V11.001H8.14L7.026 7.659L7.724 7.054L15.724 11.053ZM1 8C1 6.46 2.15 5.18 3.67 5.02L4.02 4.98L4.11 4.64C4.5 3.09 5.89 2 7.5 2C9.43 2 11 3.57 11 5.5V6H11.5C12.88 6 14 7.12 14 8.5V8.52L14.95 8.99C14.98 8.83 15 8.67 15 8.5C15 6.73 13.68 5.26 11.98 5.03C11.74 2.77 9.82 1 7.5 1C5.55 1 3.84 2.25 3.23 4.07C1.37 4.43 0 6.07 0 8C0 10.21 1.79 12 4 12H7V11H4C2.35 11 1 9.65 1 8Z\"/></svg> **Delegate this task to the GitHub Copilot cloud agent** button, next to the <svg class=\"octicon\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" xmlns=\"http://www.w3.org/2000/svg\" fill=\"currentColor\"><path d=\"M1 1.91L1.78 1.5L15 7.44899V8.3999L1.78 14.33L1 13.91L2.58311 8L1 1.91ZM3.6118 8.5L2.33037 13.1295L13.5 7.8999L2.33037 2.83859L3.6118 7.43874L9 7.5V8.5H3.6118Z\"/></svg> **Send** button.\n\n   Copilot asks you to confirm that you want to use the cloud agent to create a pull request.\n\n5. Click **Confirm**.\n\n   Copilot will start a new session and respond with a link to the pull request it creates. It will work on the task and push changes to the pull request, and then add you as a reviewer when it has finished, triggering a notification.\n\n</div>\n\n## Further reading\n\n* [Managing agent sessions](/en/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents)\n* [Best practices for using GitHub Copilot to work on tasks](/en/copilot/tutorials/cloud-agent/get-the-best-results)\n* [Troubleshooting GitHub Copilot cloud agent](/en/copilot/how-tos/use-copilot-agents/cloud-agent/troubleshoot-cloud-agent)"}