GitHub Copilot CLI: cómo instalar y usar Copilot desde la terminal

GitHub ofrece varios métodos oficiales de instalación.

npm — Windows, macOS y Linux

npm install -g @github/copilot

WinGet — Windows

winget install GitHub.Copilot

Homebrew — macOS y Linux

brew install --cask copilot-cli

Script oficial — macOS y Linux

curl -fsSL https://gh.io/copilot-install | bash

También puedes usar:

wget -qO- https://gh.io/copilot-install | bash

npm install -g @github/copilot@prerelease

En Windows:

winget install GitHub.Copilot.Prerelease

Con Homebrew:

brew install --cask copilot-cli@prerelease

copilot version

Para actualizar:

copilot update

Para consultar ayuda:

copilot help

copilot login

En una sesión interactiva también puedes utilizar:

/login

copilot login --web-flow

copilot login --device-code

Para entornos automatizados también existen variables como:

COPILOT_GITHUB_TOKEN

GH_TOKEN

GITHUB_TOKEN

cd mi-proyecto

copilot

La primera vez, Copilot puede pedirte confirmar que confías en los archivos del directorio.

Give me an overview
of this project.

Do not modify files.

Explain:

- architecture
- entry points
- modules
- data flow
- database
- external APIs
- tests
- build system
- high-risk areas

copilot -C /ruta/al/proyecto

Dentro de la sesión:

/cwd

/cd ruta/al/directorio

copilot init

O dentro de una sesión:

/init

Esto ayuda a crear instrucciones y configuración agentic adaptadas al repositorio.

En el modo interactivo puedes usar @ para añadir un archivo:

@src/auth.php

Explain how authentication works.

Para incluir un issue o Pull Request de GitHub:

#123

Anteponiendo ! puedes ejecutar directamente un comando de shell:

! git status

! npm test

! php -l plugin.php

También existe un modo de shell interactivo completo desde la propia interfaz.

copilot --plan

Prompt:

Necesitamos añadir
autenticación por OAuth.

Investiga el proyecto.

Crea un plan indicando:

- archivos
- funciones
- datos
- configuración
- cambios de DB
- seguridad
- tests
- riesgos

No modifiques
ningún archivo todavía.

Dentro de una sesión:

/autopilot

/goal Fix the failing authentication tests

Desde línea de comandos:

copilot --autopilot

copilot --autopilot --yolo

También puedes limitar el número de continuaciones:

copilot \
  --autopilot \
  --yolo \
  --max-autopilot-continues 10 \
  -p "Fix the failing integration tests"

copilot --plan --mode autopilot

Este workflow permite comenzar con razonamiento de planificación y pasar automáticamente a ejecución cuando el plan está preparado.

copilot -p "Explain the architecture of this repository"

El proceso termina después de completar la respuesta.

copilot -i "Review the current repository"

A diferencia de -p, la sesión permanece interactiva.

Para continuar la sesión más reciente:

copilot --continue

Para elegir una sesión:

copilot --resume

También:

/resume

Copilot CLI dispone de una barra lateral de sesiones para mantener varios trabajos abiertos.

Copilot CLI
│
├── Session A
│   └── auth bug
│
├── Session B
│   └── API tests
│
└── Session C
    └── documentation

Dentro de una sesión:

/model

Al iniciar:

copilot --model auto

Auto permite que Copilot seleccione automáticamente un modelo disponible.

La lista exacta puede cambiar según tu plan, disponibilidad y políticas, pero el CLI admite modelos de familias como:

copilot --effort high

Dependiendo del modelo pueden existir niveles como:

copilot --yolo

Es equivalente a:

copilot --allow-all

Dentro de una sesión:

/yolo

/allow-all

/sandbox status

/sandbox policy

En entornos donde esta función está habilitada, el sandbox permite restringir filesystem y acceso de red para comandos y herramientas.

Copilot CLI puede combinar instrucciones desde varias ubicaciones.

AGENTS.md

CLAUDE.md

GEMINI.md

.github/copilot-instructions.md

.github/instructions/*.instructions.md

También existen instrucciones personales:

~/.copilot/copilot-instructions.md

~/.copilot/instructions/*.instructions.md

copilot instruction list

Para obtener JSON:

copilot instruction list --json

Dentro de una sesión:

/instructions

/env

Una Skill es una carpeta que puede contener:

.github/
└── skills/
    └── security-review/
        ├── SKILL.md
        └── scripts/

También:

.agents/skills/

.claude/skills/

copilot skill

La CLI permite gestionar Skills sin necesidad de abrir una sesión interactiva.

Los Custom Agents pueden vivir a nivel de proyecto:

.github/
└── agents/
    ├── security-auditor.agent.md
    ├── tester.agent.md
    └── architect.agent.md

O a nivel personal:

~/.copilot/agents/

Dentro de una sesión:

/agent

O directamente:

copilot \
  --agent security-auditor \
  --prompt "Review the authentication module"

Review this feature.

Delegate independently:

1. architecture analysis
2. security review
3. test coverage review

Run independent work
in parallel.

Do not modify files.

Combine the findings
and remove duplicates.

Copilot CLI dispone además del comando:

/fleet Review the repository for security regressions

para distribuir partes independientes de una tarea entre Subagents.

/tasks

Desde ahí puedes inspeccionar Subagents activos y trabajos ejecutándose en segundo plano.

Copilot CLI ya incluye integración con GitHub mediante MCP y puede incorporar servidores adicionales.

copilot mcp list

Añadir un servidor HTTP:

copilot mcp add \
  --transport http \
  mi-servidor \
  https://ejemplo.com/mcp

Servidor local:

copilot mcp add \
  mi-servidor-local \
  -- comando argumentos

Los Hooks permiten disparar comandos cuando ocurren eventos del agente.

.github/
└── hooks/
    └── tests.json

Eventos disponibles incluyen:

Los Plugins pueden combinar componentes como:

Ver marketplaces:

copilot plugin marketplace list

Instalar:

copilot plugin install \
  PLUGIN@MARKETPLACE

Administrar:

copilot plugin list

copilot plugin update PLUGIN

copilot plugin uninstall PLUGIN

/diff

El modo Diff permite navegar entre archivos, revisar cambios y añadir comentarios directamente sobre líneas.

/review

Puedes añadir instrucciones:

/review Focus on:

- regressions
- security
- data loss
- authentication
- authorization
- missing tests

Crear un worktree:

/worktree

O iniciar Copilot directamente en un worktree:

copilot --worktree

Esto permite aislar:

/delegate complete the API integration tests
and fix any failing edge cases

También puedes anteponer &:

& complete the API integration tests
and fix any failing edge cases

/ide

Esto permite conectar la sesión CLI con un workspace compatible de VS Code para compartir contexto y trabajar entre ambas superficies.

/settings

Configuración personal:

~/.copilot/settings.json

Configuración versionable del repositorio:

.github/copilot/settings.json

Copilot CLI permite establecer límites suaves de créditos.

copilot --max-ai-credits 5

Dentro de la sesión:

/limits