# Using Copilot cloud agent from Raycast

Start and track Copilot-Cloud-Agent sessions from the Raycast launcher.

[Raycast](https://www.raycast.com/) ist ein erweiterbares Startprogramm für Windows und macOS. Mit der GitHub Copilot Erweiterung für Raycast können Sie Aufgaben starten und nachverfolgen Copilot-Cloud-Agent und Sitzungsprotokolle live ansehen, wo immer Sie sich auf Ihrem Computer befinden.

## Prerequisites

1. Installiere Raycast von der [Raycast-Website](https://www.raycast.com).
2. Installieren Sie die GitHub Copilot Erweiterung für Raycast, indem Sie auf der **Seite der Erweiterung** auf die Schaltfläche "[Erweiterung](https://www.raycast.com/github/github-copilot) installieren" klicken.

## Starting a session

1. Open Raycast, search for "Copilot," find the **Create Task** command, then press <kbd>Enter</kbd>.
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. Wählen Sie optional ein Benutzerdefinierter Agent mit speziellem Verhalten und speziellen Tools aus dem Dropdownmenü. Weitere Informationen finden Sie unter [Erstellen von benutzerdefinierten Agents für Copilot-Cloud-Agent](/de/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents).
7. Optional können Sie das Dropdownmenü verwenden, um das zu verwendende Modell Copilot auszuwählen. Weitere Informationen findest du unter [Ändern des KI-Modells für GitHub Copilot Cloud-Agent](/de/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model).
8. Press <kbd>Command</kbd>+<kbd>Enter</kbd> (macOS) or <kbd>Ctrl</kbd>+<kbd>Enter</kbd> (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]
>
> Wenn Sie beim Starten einer Aufgabe kein bestimmtes Repository auswählen können, hat die Organisation, die das Repository besitzt, möglicherweise Zugriffsbeschränkungen aktiviert OAuth app . Informationen zum Anfordern der Genehmigung für „GitHub Copilot für Raycast” OAuth app finden Sie unter [Von einer Organisation die Genehmigung für OAuth-Apps anfordern](/de/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/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 <kbd>Enter</kbd>.
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. Wählen Sie optional ein Benutzerdefinierter Agent mit speziellem Verhalten und speziellen Tools aus dem Dropdownmenü. Weitere Informationen finden Sie unter [Erstellen von benutzerdefinierten Agents für Copilot-Cloud-Agent](/de/copilot/how-tos/use-copilot-agents/cloud-agent/create-custom-agents).
7. Optional können Sie das Dropdownmenü verwenden, um das zu verwendende Modell Copilot auszuwählen. Weitere Informationen findest du unter [Ändern des KI-Modells für GitHub Copilot Cloud-Agent](/de/copilot/how-tos/use-copilot-agents/cloud-agent/changing-the-ai-model).
8. Optionally, provide additional instructions. These will be passed to Copilot alongside your issue contents.
9. Press <kbd>Command</kbd>+<kbd>Enter</kbd> (macOS) or <kbd>Ctrl</kbd>+<kbd>Enter</kbd> (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]
>
> Wenn Sie beim Starten einer Aufgabe kein bestimmtes Repository auswählen können, hat die Organisation, die das Repository besitzt, möglicherweise Zugriffsbeschränkungen aktiviert OAuth app . Informationen zum Anfordern der Genehmigung für „GitHub Copilot für Raycast” OAuth app finden Sie unter [Von einer Organisation die Genehmigung für OAuth-Apps anfordern](/de/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/requesting-organization-approval-for-oauth-apps).

## Tracking your sessions

1. Open Raycast, search for "Copilot," find the **View Tasks** command, then press <kbd>Enter</kbd>.
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 <kbd>Enter</kbd>. 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 <kbd>Command</kbd>+<kbd>Enter</kbd> (macOS) or <kbd>Ctrl</kbd>+<kbd>Enter</kbd> (Windows).
   * To open the linked pull request, press <kbd>Command</kbd>+<kbd>P</kbd> (macOS) or <kbd>Ctrl</kbd>+<kbd>P</kbd> (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 [Von einer Organisation die Genehmigung für OAuth-Apps anfordern](/de/account-and-profile/how-tos/setting-up-and-managing-your-personal-account-on-github/managing-your-membership-in-organizations/requesting-organization-approval-for-oauth-apps).

## Further reading

* [Verwalten von Agent-Sitzungen](/de/copilot/how-tos/copilot-on-github/use-copilot-agents/manage-and-track-agents)
* [Bewährte Methoden für die Verwendung von GitHub Copilot für die Arbeit an Vorgängen](/de/copilot/tutorials/cloud-agent/get-the-best-results)