{"meta":{"title":"Using Copilot cloud agent from Raycast","intro":"Start and track Copilot cloud agent sessions from the Raycast launcher.","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-from-raycast","title":"Use cloud agent from Raycast"}],"documentType":"article"},"body":"# Using Copilot cloud agent from Raycast\n\nStart and track Copilot cloud agent sessions from the Raycast launcher.\n\n[Raycast](https://www.raycast.com/) is an extensible launcher for Windows and macOS. With the GitHub Copilot extension for Raycast, you can start and track Copilot cloud agent tasks and watch session logs live wherever you are on your computer.\n\n## Prerequisites\n\n1. Install Raycast from the [Raycast website](https://www.raycast.com).\n2. Install the GitHub Copilot extension for Raycast by clicking the **Install Extension** button on the [extension's page](https://www.raycast.com/github/github-copilot).\n\n## Starting a session\n\n1. Open Raycast, search for \"Copilot,\" find the **Create Task** command, then press <kbd>Enter</kbd>.\n2. Click **Sign in with GitHub**, then complete the authentication flow. Raycast will re-open.\n3. Type a prompt describing what you want Copilot to do.\n\n   For example, `Implement a user friendly message for common errors.`\n4. Select the repository you want Copilot to work in.\n5. Optionally, select a base branch for Copilot's pull request. Copilot will create a new branch based on this branch, then push the changes to a pull request targeting that branch.\n6. Optionally, select a custom agent with specialized behavior and tools from the dropdown menu. For more information, see [Creating custom agents for Copilot cloud agent](/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents).\n7. Optionally, you can use the dropdown menu to select the model that Copilot will use. If the selected model supports configurable reasoning, you can also use the dropdown menu to select the reasoning level. For more information, see [Changing the AI model for GitHub Copilot cloud agent](/en/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model).\n8. Press <kbd>Command</kbd>+<kbd>Enter</kbd> (macOS) or <kbd>Ctrl</kbd>+<kbd>Enter</kbd> (Windows) to start the task.\n\n   Copilot will start a new session. Copilot will work on the task and push changes to its pull request, then add you as a reviewer when it has finished, triggering a notification.\n\n> \\[!NOTE]\n>\n> If you are unable to select a specific repository when starting a task, the organization that owns the repository may have enabled OAuth app access restrictions. To learn how to request approval for the \"GitHub Copilot for Raycast\" OAuth app, see [Requesting organization approval for OAuth apps](/en/account-and-profile/how-tos/organization-membership/requesting-organization-approval-for-oauth-apps).\n\n## Assigning an issue from Raycast\n\n1. Open Raycast, search for \"Copilot,\" find the **Assign Issues to Copilot** command, then press <kbd>Enter</kbd>.\n2. Click **Sign in with GitHub**, then complete the authentication flow. Raycast will re-open.\n3. Select the repository you want Copilot to work in.\n4. Select the issue you want to assign to Copilot.\n5. Optionally, select a base branch for Copilot's pull request. Copilot will create a new branch based on this branch, then push the changes to a pull request targeting that branch.\n6. Optionally, select a custom agent with specialized behavior and tools from the dropdown menu. For more information, see [Creating custom agents for Copilot cloud agent](/en/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents).\n7. Optionally, you can use the dropdown menu to select the model that Copilot will use. If the selected model supports configurable reasoning, you can also use the dropdown menu to select the reasoning level. For more information, see [Changing the AI model for GitHub Copilot cloud agent](/en/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model).\n8. Optionally, provide additional instructions. These will be passed to Copilot alongside your issue contents.\n9. Press <kbd>Command</kbd>+<kbd>Enter</kbd> (macOS) or <kbd>Ctrl</kbd>+<kbd>Enter</kbd> (Windows) to assign the issue.\n\n   Copilot will start a new session. Copilot will work on the task and push changes to its pull request, then add you as a reviewer when it has finished, triggering a notification.\n\n> \\[!NOTE]\n>\n> If you are unable to select a specific repository when starting a task, the organization that owns the repository may have enabled OAuth app access restrictions. To learn how to request approval for the \"GitHub Copilot for Raycast\" OAuth app, see [Requesting organization approval for OAuth apps](/en/account-and-profile/how-tos/organization-membership/requesting-organization-approval-for-oauth-apps).\n\n## Tracking your sessions\n\n1. Open Raycast, search for \"Copilot,\" find the **View Tasks** command, then press <kbd>Enter</kbd>.\n2. Click **Sign in with GitHub**, then complete the authentication flow. Raycast will re-open.\n3. You'll see a list of your tasks. Select a task, then use the following keyboard shortcuts:\n   * To watch the session logs live, press <kbd>Enter</kbd>. The logs update in real time, so you can monitor Copilot's progress without leaving Raycast.\n   * To open the session logs in the browser, press <kbd>Command</kbd>+<kbd>Enter</kbd> (macOS) or <kbd>Ctrl</kbd>+<kbd>Enter</kbd> (Windows).\n   * To open the linked pull request, press <kbd>Command</kbd>+<kbd>P</kbd> (macOS) or <kbd>Ctrl</kbd>+<kbd>P</kbd> (Windows).\n\n> \\[!NOTE]\n> If you are unable to see some tasks in Raycast, the organization that owns the repository may have enabled OAuth app access restrictions. To learn how to request approval for the \"GitHub Copilot for Raycast\" OAuth app, see [Requesting organization approval for OAuth apps](/en/account-and-profile/how-tos/organization-membership/requesting-organization-approval-for-oauth-apps).\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)"}