GUÍA DE PROVEEDOR
GitHub Copilot
Despacha tareas al modo agente de GitHub Copilot mediante el protocolo ACP. Tu suscripción personal de Copilot hace el trabajo de código — CTRL NODE se encarga del despacho remoto y del streaming de salida.
PAT de grano fino Protocolo ACP Solo cuentas personales
Requisitos
- ✓ Una cuenta de GitHub con una suscripción activa a Copilot (Individual o Pro)
- ✓ CTRL NODE Bridge instalado en tu máquina (GitHub)
- ✓ Modo suscripción — GitHub CLI (
gh) instalado y autenticado. No hace falta PAT. - ✓ Modo PAT — un token de acceso personal de grano fino con el permiso Copilot Requests.
Importante: los tokens de organización no funcionan. Debes crear un token de acceso personal de grano fino en tu cuenta personal de GitHub con el permiso Copilot Requests habilitado.
Crear un PAT de grano fino
- 1. Ve a GitHub → Settings → Developer settings → Fine-grained tokens → New token
- 2. Configura Resource owner con tu cuenta personal (no una organización)
- 3. En Permissions → Account permissions, busca Copilot Requests y configúralo como Read and write
- 4. Genera el token y cópialo
Inicio rápido
Opción A — Inicio de sesión con GitHub CLI
RecomendadoRequiere GitHub CLI — no hace falta PAT, solo tu suscripción a Copilot.
$gh auth login # autenticar una vez
$ PAIRING_TOKEN=tu-token-de-emparejamiento \
./ctrlnode
./ctrlnode
Opción B — PAT de grano fino
$ PAIRING_TOKEN=tu-token-de-emparejamiento \
COPILOT_GITHUB_TOKEN=github_pat_… \
./ctrlnode
COPILOT_GITHUB_TOKEN=github_pat_… \
./ctrlnode
Crea un PAT de grano fino con el permiso Copilot Requests.
Archivo .env
PAIRING_TOKEN=tu-token-de-emparejamiento
# modo gh auth login — no hace falta variable de token
# O: modo PAT
COPILOT_GITHUB_TOKEN=github_pat_…
Variables de entorno
| Variable | Obligatoria | Descripción |
|---|---|---|
| COPILOT_GITHUB_TOKEN | Sí | PAT de grano fino con el permiso Copilot Requests. |
Cómo el Bridge despacha tareas a Copilot
Cuando CTRL NODE despacha una tarea a un agente de Copilot:
- El Bridge se conecta al endpoint ACP (Agent Control Protocol) de GitHub usando tu PAT.
- Envía la descripción de la tarea como una sesión de Copilot con el workspace del agente como contexto.
- Las respuestas y ediciones de código se transmiten de vuelta por el WebSocket a CTRL NODE en tiempo real.
- Al finalizar, el estado de la tarea se actualiza en el panel. No se almacenan datos en el servidor.