GitHub Copilot

GitHub Copilot es el proveedor con el que arranca OAR: siempre está disponible y usa la CLI de Copilot que tiene la sesión iniciada en el host del relay. El relay lo ejecuta en uno de dos motores. El motor SDK es el predeterminado y te da la corrección del rumbo, un panel para las tareas en segundo plano y preguntas de selección múltiple. El motor Extension ejecuta la CLI de Copilot real en una terminal que puedes observar.

OpenAI con tu propia clave corre en los mismos dos motores, así que las secciones de esta página sobre los motores también se le aplican. Su clave y sus modelos están en la página de OpenAI.

Lo que necesitas #

• La CLI de Copilot, con la sesión iniciada, en el host del relay. Instálala con npm install -g @github/copilot, ejecuta copilot una vez e inicia sesión. Tu cuenta de GitHub necesita un plan de Copilot que incluya Copilot CLI.
• Un reinicio del relay después de instalar o actualizar la CLI. El relay busca la runtime de la CLI al arrancar y no ve una instalación posterior.
• La CLI de GitHub (gh), con la sesión iniciada, para oar copilot, las sesiones del motor Extension en Windows y la tarjeta de Copilot en Check Usage (Ver consumo).
• tmux (opcional, Linux y macOS) si quieres observar la terminal de una sesión con 🖥️ Inspect tmux console (Inspeccionar la consola de tmux).

El relay no instala ni actualiza la CLI de Copilot. En Settings → Providers → Copilot (Ajustes → Proveedores → Copilot), la fila GitHub Copilot CLI de arriba solo informa de su estado.

Cómo encuentra OAR la CLI #

El motor SDK controla la runtime que viene con la CLI de Copilot. Al arrancar, el relay busca en la caché de paquetes de la CLI y toma la versión más reciente que hay allí:

En Linux, las dos carpetas siguen XDG_CACHE_HOME y XDG_DATA_HOME cuando las defines. Define COPILOT_PKG_DIR para añadir una carpeta de búsqueda, o COPILOT_SDK_PATH para indicar directamente el directorio copilot-sdk de la runtime. Si no se encuentra nada, el motor SDK no está disponible (consulta Elegir el motor).

Usar oar copilot #

oar copilot arranca el relay en segundo plano si ninguno responde en su puerto, y luego abre la CLI de Copilot (gh copilot) en tu shell. Un relay que haya arrancado él se detiene de nuevo cuando termina la sesión. Los argumentos después de -- van a gh copilot.

oar copilot
oar copilot --port 3400 -- --help

Cada ejecución también escribe o actualiza un pequeño envoltorio en ~/.copilot/extensions/web-relay/, una extensión global del usuario que carga la extensión de OAR en la CLI de Copilot. oar copilot --install-extension solo hace eso y termina (no necesita gh); --no-install-extension se lo salta en una ejecución. Si falta gh, oar copilot lo dice y se detiene; instala la CLI de GitHub o ejecuta solo el relay con oar start.

Los dos motores #

Los dos motores muestran la misma transcripción, las mismas tarjetas de pregunta, los mismos tableros del plan, la misma lista de modelos y la misma línea de consumo por respuesta. Consulta Los turns y la queue para Steer, Queue (Poner en cola) y las ventanas de turns atascados, Modos del relay y Compactación para esas filas, y ask_user para las tarjetas de pregunta.

En el motor SDK, Stop solo termina la respuesta. Los agentes en segundo plano que inició el turn siguen corriendo, cada uno con su propio Stop en el panel de tareas.

Elegir el motor #

La elección es un único ajuste para todo el relay: Settings → Providers → Copilot → Copilot engine (Ajustes → Proveedores → Copilot → Motor de Copilot), con las opciones Extension (Extensión) y SDK — default (SDK — predeterminado). Pulsa Save Copilot settings (Guardar los ajustes de Copilot) después de cambiarlo.

• Se aplica a las conversaciones cuyo worker arranca después. Una sesión que ya está en curso conserva su motor hasta que se reinicia su worker.
• Si nadie ha guardado una elección, el relay usa SDK siempre que puede y Extension cuando no puede. Una elección guardada siempre tiene prioridad. Eso incluye un SDK guardado: si en un reinicio posterior ya no encuentra la CLI, el relay no vuelve atrás por su cuenta, y el worker de una conversación nueva no puede arrancar hasta que se encuentre de nuevo la CLI o guardes Extension.
• El panel dice qué motor está fijado: New Copilot conversations run on the headless SDK worker. No tmux inspector for these sessions. o New Copilot conversations run on the Copilot CLI with the web-relay extension.

Para saber qué motor usa una conversación en curso, mira su área de redacción y su consola de tmux. Durante un turn, el botón de enviar dice Steer en el motor SDK (allí dice Queue mientras hay abierta una tarjeta de pregunta o una aprobación, el turn está compactando o se está ejecutando una llamada a herramienta) y siempre Queue en el motor Extension. La consola de tmux muestra una pantalla de Copilot solo en el motor Extension. La conversación en sí no lleva ninguna etiqueta de motor.

Cuando se rechaza guardar SDK #

El relay se niega a guardar SDK cuando no podría ejecutarlo, y muestra el motivo en lugar de la descripción del motor. El ajuste guardado no cambia, y el selector vuelve al motor que el relay ejecuta realmente.

Ajustes #

En Settings → Providers → Copilot:

Otros ajustes que afectan a las sesiones de Copilot están en otros lugares:

Modelos #

El relay lee la lista de modelos de la runtime de la CLI de Copilot instalada unos segundos después de arrancar. Cada modelo muestra los reasoning efforts y la ventana de contexto que informa la runtime. La lista empieza por auto y luego agrupa los modelos por fabricante (OpenAI, Anthropic, Google, xAI, Microsoft, Azure OpenAI, Moonshot AI y después los demás por orden alfabético), con la versión más reciente primero.

Hasta la primera detección, un relay nuevo ofrece gpt-5.4, gpt-5.4-mini (el predeterminado), gpt-5.3-codex, claude-sonnet-4.6 y claude-haiku-4.5.

Usa 🤗 Select Models → Copilot (Seleccionar modelos → Copilot) en el menú ⋯ de una conversación para elegir qué modelos aparecen en el área de redacción, y luego 💾 Save enabled models (Guardar los modelos activados). Refresh (Actualizar) vuelve a leer la lista. Si la lista parece antigua, pulsa Refresh.

Consumo #

• Debajo de una respuesta, un turn de Copilot muestra lo que ha usado: +N para los créditos, con la parte de tu plan mensual entre paréntesis, y month N% left. Una etiqueta stale significa que los números no se pudieron actualizar en ese turn. Solo los turns de Copilot tienen esta línea; los demás proveedores, OpenAI incluido, no usan créditos de Copilot.
• En la cabecera, una línea de sesión suma la conversación, por ejemplo Session: 1.25 AIC used.
• En Check Usage, abre 📊 Check Usage en el menú ⋯ y elige la pestaña de Copilot para ver la cuota en vivo (créditos de IA o solicitudes premium, chat y plan). En el motor SDK añade Last SDK worker turn: los créditos que gastó realmente ese turn, sus tokens y sus llamadas al modelo. Son los números de un solo turn, no un total acumulado, y la sección desaparece al cabo de siete días.

La tarjeta de Copilot lee tu cuenta a través de gh. Si no usas gh, define GH_TOKEN o GITHUB_TOKEN en el entorno del relay.

Importar las sesiones que ya tienes #

Cuando el relay arranca, importa las sesiones de Copilot guardadas en el host, para que aparezcan en tu lista con su historial. Las lee a través de la runtime de Copilot instalada. Si la runtime no está disponible, la importación se informa como fallida. El relay no intenta adivinar a partir de los archivos.

Eliminar una sesión así solo la oculta: la sesión propia de la CLI de Copilot se queda, porque el relay nunca la ejecutó.

Variables de entorno #

Defínelas en el entorno del proceso del relay y luego reinicia el relay.

Límites #

• El relay necesita un reinicio para notar una CLI de Copilot que se instaló o actualizó después de arrancar.
• En el motor SDK no hay ninguna terminal a la que conectarse.
• Los mensajes enviados durante un turn se ponen en cola en el motor Extension; no pueden corregir el rumbo.
• En el motor SDK, el relay da a un turn 2 minutos de silencio sin nada en marcha, 5 minutos durante una petición al modelo y 30 minutos mientras corre una herramienta antes de darlo por fallido. Un turn que espera en una tarjeta de pregunta nunca se considera atascado. Las ventanas están en Los turns y la queue.
• Una conversación de OpenAI con tu propia clave también usa estos motores, pero gasta tu clave, así que sus turns no llevan línea de consumo de Copilot.

Si no funciona #

Las sesiones de agente, los modos del relay y el resto del comportamiento que no depende del motor funcionan como se describe en las páginas de sesiones y de agentes que trabajan juntos.