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

# GitHub Copilot provider

> Bridge provider copilot — Copilot CLI via Agent Client Protocol (ACP)

Provider id: **`copilot`** · CtrlNode agent type: **`Copilot`**

Spawns the [`@github/copilot`](https://www.npmjs.com/package/@github/copilot) CLI and speaks **ACP** over stdio. Each dispatch opens a fresh ACP session.

## When to use it

* You have **GitHub Copilot** access and want Copilot to execute coding tasks from CtrlNode
* You already use `copilot` in the terminal on the Bridge machine

## Prerequisites

* **Node.js 22+**
* Copilot CLI:

```bash theme={null}
npm install -g @github/copilot
copilot --version
```

## Authentication

**Option A — fine-grained PAT**

1. Create a token at [GitHub fine-grained PAT settings](https://github.com/settings/personal-access-tokens/new)
2. Enable **Copilot Requests** (read & write) — available on **personal** tokens
3. Set:

```env theme={null}
COPILOT_GITHUB_TOKEN=github_pat_...
```

**Option B — interactive login**

```bash theme={null}
copilot login
```

Omit `COPILOT_GITHUB_TOKEN` when the CLI session is cached.

## Environment variables

| Variable                  | Default | Description                          |
| ------------------------- | ------- | ------------------------------------ |
| `COPILOT_GITHUB_TOKEN`    | —       | PAT with Copilot Requests permission |
| `COPILOT_TIMEOUT_MINUTES` | `10`    | Task timeout                         |
| `BASE_PATH`               | Home    | Workspace root                       |

## Example `.env`

```env theme={null}
PAIRING_TOKEN=...
PROVIDERS=copilot
COPILOT_GITHUB_TOKEN=github_pat_...
```

## CtrlNode setup

1. Project agent type **Copilot**
2. Register agents in **Team**
3. Assign tasks; agent **instructions** are prepended to the prompt

## Troubleshooting

| Issue                             | Fix                                                             |
| --------------------------------- | --------------------------------------------------------------- |
| Copilot permission missing on PAT | Use personal fine-grained token with Copilot Requests           |
| `copilot` not found               | `npm install -g @github/copilot`; fix PATH                      |
| 401 on dispatch                   | Re-run `copilot login` or rotate PAT                            |
| Org token fails                   | Copilot Requests not available on org tokens — use personal PAT |

[← All providers](/bridge/providers)