Saltar al contenido principal

Incluir Copilot CLI en el proyecto

Si quieres controlar de forma estricta la versión de Copilot CLI, puedes incluirlo en el proyecto como paquete npm. Por lo general basta con instalar Copilot CLI por separado en el despliegue.
Consulta también Uso en Laravel Cloud y Uso en GitHub Actions.

Requisitos previos

El proyecto Laravel tiene package.json y el servidor de producción cuenta con un entorno Node.js, por lo que puedes instalar paquetes npm.

Configuración

1. Instala el paquete npm

Instala @github/copilot en dependencies.
npm install @github/copilot
Tras la instalación, puedes ejecutar Copilot CLI directamente con esta ruta:
node node_modules/@github/copilot/npm-loader.js --version
A partir de Copilot CLI 1.0.64, index.js solo está incluido en los paquetes específicos de cada plataforma. Si quieres usar index.js, hazlo según tu entorno:
node node_modules/@github/copilot-linux-x64/index.js --version

2. Configura .env

En COPILOT_CLI_PATH, indica la ruta completa hasta npm-loader.js.
COPILOT_CLI_PATH=/path/to/project/node_modules/@github/copilot/npm-loader.js
Si quieres definir la ruta dinámicamente con base_path(), edita directamente config/copilot.php:
'cli_path' => base_path('node_modules/@github/copilot/npm-loader.js'),

Despliegue

Al desplegar en producción, después de compilar los assets, reinstala excluyendo devDependencies. Como @github/copilot está en dependencies, permanece.
npm install
npm run build
npm install --omit=dev
npm install --omit=dev elimina los paquetes de devDependencies y deja en node_modules únicamente los de dependencies, incluidos @github/copilot.

Ventajas y consideraciones

VentajasConsideraciones
Permite controlar de forma estricta la versión del CLIAumenta el tamaño de node_modules
Puedes fijar la versión en package.jsonDebes actualizar el CLI manualmente
Todo el equipo usa la misma versiónNecesitas un entorno Node.js

Autenticación

El método de autenticación es el mismo independientemente de cómo lo instales. Configura COPILOT_GITHUB_TOKEN en .env.
COPILOT_GITHUB_TOKEN=your-token
Para más detalles consulta Autenticación.
Consulta la información más reciente en el repositorio de GitHub.
Última modificación el 13 de julio de 2026