GitHub Copilot provider - CtrlNode

Provider id: copilot · CtrlNode agent type: Copilot Spawns the @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:

npm install -g @github/copilot
copilot --version

Authentication

Option A — fine-grained PAT

Create a token at GitHub fine-grained PAT settings
Enable Copilot Requests (read & write) — available on personal tokens
Set:

COPILOT_GITHUB_TOKEN=github_pat_...

Option B — interactive login

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`

PAIRING_TOKEN=...
PROVIDERS=copilot
COPILOT_GITHUB_TOKEN=github_pat_...

CtrlNode setup

Project agent type Copilot
Register agents in Team
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