Using Copilot cloud agent from Raycast

Start and track Copilot cloud agent sessions from the Raycast launcher.

Who can use this feature?

Copilot cloud agent is available for all paid Copilot plans.

The agent is available in all repositories stored on GitHub, except repositories owned by managed user accounts and where it has been explicitly disabled.
Sign up for Copilot

In this article

Raycast 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.

Prerequisites

  1. Install Raycast from the Raycast website.
  2. Install the GitHub Copilot extension for Raycast by clicking the Install Extension button on the extension's page.

Starting a session

  1. Open Raycast, search for "Copilot," find the Create Task command, then press Enter.

  2. Click Sign in with GitHub, then complete the authentication flow. Raycast will re-open.

  3. Type a prompt describing what you want Copilot to do.

    For example, Implement a user friendly message for common errors.

  4. Select the repository you want Copilot to work in.

  5. 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.

  6. 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.

  7. Optionally, you can use the dropdown menu to select the model that Copilot will use. For more information, see Changing the AI model for GitHub Copilot cloud agent.

  8. Press Command+Enter (macOS) or Ctrl+Enter (Windows) to start the task.

    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.

Note

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.

Assigning an issue from Raycast

  1. Open Raycast, search for "Copilot," find the Assign Issues to Copilot command, then press Enter.

  2. Click Sign in with GitHub, then complete the authentication flow. Raycast will re-open.

  3. Select the repository you want Copilot to work in.

  4. Select the issue you want to assign to Copilot.

  5. 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.

  6. 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.

  7. Optionally, you can use the dropdown menu to select the model that Copilot will use. For more information, see Changing the AI model for GitHub Copilot cloud agent.

  8. Optionally, provide additional instructions. These will be passed to Copilot alongside your issue contents.

  9. Press Command+Enter (macOS) or Ctrl+Enter (Windows) to assign the issue.

    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.

Note

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.

Tracking your sessions

  1. Open Raycast, search for "Copilot," find the View Tasks command, then press Enter.
  2. Click Sign in with GitHub, then complete the authentication flow. Raycast will re-open.
  3. You'll see a list of your tasks. Select a task, then use the following keyboard shortcuts:
    • To watch the session logs live, press Enter. The logs update in real time, so you can monitor Copilot's progress without leaving Raycast.
    • To open the session logs in the browser, press Command+Enter (macOS) or Ctrl+Enter (Windows).
    • To open the linked pull request, press Command+P (macOS) or Ctrl+P (Windows).

Note

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.

Further reading