Skip to main content

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.

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
  1. Create a token at GitHub fine-grained PAT settings
  2. Enable Copilot Requests (read & write) — available on personal tokens
  3. Set:
COPILOT_GITHUB_TOKEN=github_pat_...
Option B — interactive login 
copilot login
Omit COPILOT_GITHUB_TOKEN when the CLI session is cached.

​
Environment variables

VariableDefaultDescription
COPILOT_GITHUB_TOKEN—PAT with Copilot Requests permission
COPILOT_TIMEOUT_MINUTES10Task timeout
AGENTS_FOLDERHomeWorkspace root

​
Example .env

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

IssueFix
Copilot permission missing on PATUse personal fine-grained token with Copilot Requests
copilot not foundnpm install -g @github/copilot; fix PATH
401 on dispatchRe-run copilot login or rotate PAT
Org token failsCopilot Requests not available on org tokens — use personal PAT
← All providers