> ## Documentation Index
> Fetch the complete documentation index at: https://www.edgee.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub Copilot Desktop (Beta)

> Route local GitHub Copilot desktop sessions through Edgee on macOS.

> [!NOTE]
>
> **Beta:** this integration is available for testing and may have limitations.

Use the GitHub Copilot desktop app with your existing Copilot subscription. This launch target supports **macOS only** and covers **local sessions**. Remote sessions are outside its scope.

## Connect through Edgee

**1. Install the Edgee CLI**

> [tab] macOS / Linux
>
> ```bash theme={"dark"}
> curl -fsSL https://edgee.ai/install.sh | bash
>
> # Accept the alias prompt (recommended).
> # If skipped: edgee alias
> # Reopen your terminal afterward.
> ```

> [tab] Homebrew (macOS)
>
> ```bash theme={"dark"}
> brew install edgee-ai/tap/edgee
>
> # Enable aliases (recommended).
> edgee alias
> # Reopen your terminal afterward.
> ```

> [tab] Windows (PowerShell)
>
> ```powershell theme={"dark"}
> irm https://edgee.ai/install.ps1 | iex
>
> # Enable aliases (recommended).
> edgee alias
> # Reopen your terminal afterward.
> ```

**2. Launch GitHub Copilot Desktop through Edgee**

> [tab] With aliases (recommended)
>
> Open **GitHub Copilot (Edgee)** from your app menu. See [desktop shortcuts](https://www.edgee.ai/docs/cli/aliases.md) for availability on your platform.

> [tab] Without aliases
>
> ```bash theme={"dark"}
> edgee launch copilot-desktop
> ```

Edgee starts sign-in automatically if needed. Follow the prompts and select your organization when asked.

Start a local coding session. Usage is grouped under Copilot in Edgee. Edgee plugin delivery is not supported for this app.

## Verify the connection

Send a request, then open **Logs** in the same Edgee organization. Check its model, provider, and usage. Open **Sessions** to inspect the coding session.

If requests are missing, confirm you launched through Edgee and used the supported surface described above. For desktop apps, close any existing instance and relaunch through Edgee. See [Troubleshooting](https://www.edgee.ai/docs/troubleshooting.md).

## Next steps

* [Routing strategies](https://www.edgee.ai/docs/features/routing-strategies.md): apply your team’s routing policy.
* [Sessions](https://www.edgee.ai/docs/features/observability/sessions.md): inspect requests and usage.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.