> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Bundle du Copilot CLI

> Découvrez comment intégrer le Copilot CLI comme dépendance npm de votre projet Laravel lorsque vous souhaitez en verrouiller strictement la version.

## Inclure le Copilot CLI dans le projet

Si vous souhaitez contrôler strictement la version du Copilot CLI, vous pouvez l'inclure dans votre projet en tant que paquet npm.

En général, installer le Copilot CLI séparément lors du déploiement suffit.
Voir aussi [Utilisation avec Laravel Cloud](/fr/packages/laravel-copilot-sdk/laravel-cloud) et [Utilisation avec GitHub Actions](/fr/packages/laravel-copilot-sdk/github-actions).

## Prérequis

Votre projet Laravel possède un `package.json` et votre serveur de production dispose d'un environnement Node.js, ce qui vous permet d'installer des paquets npm.

## Mise en place

### 1. Installer le paquet npm

Installez `@github/copilot` dans les `dependencies`.

```shell theme={null}
npm install @github/copilot
```

Après installation, vous pouvez exécuter le Copilot CLI directement via le chemin suivant.

```shell theme={null}
node node_modules/@github/copilot/npm-loader.js --version
```

À partir de Copilot CLI 1.0.64, `index.js` n'est inclus que dans les paquets par plateforme. Si vous utilisez `index.js`, adaptez-le à votre environnement.

```shell theme={null}
node node_modules/@github/copilot-linux-x64/index.js --version
```

### 2. Configurer `.env`

Indiquez dans `COPILOT_CLI_PATH` le chemin complet vers `npm-loader.js`.

```dotenv theme={null}
COPILOT_CLI_PATH=/path/to/project/node_modules/@github/copilot/npm-loader.js
```

Pour définir le chemin dynamiquement avec `base_path()`, modifiez directement `config/copilot.php`.

```php theme={null}
'cli_path' => base_path('node_modules/@github/copilot/npm-loader.js'),
```

## Déploiement

Lors du déploiement en production, après la construction des assets, réinstallez sans les `devDependencies`. `@github/copilot` étant dans les `dependencies`, il est conservé.

```shell theme={null}
npm install
npm run build
npm install --omit=dev
```

`npm install --omit=dev` retire les paquets des `devDependencies` et ne laisse dans `node_modules` que les paquets des `dependencies`, dont `@github/copilot`.

## Avantages et points d'attention

| Avantages                              | Points d'attention                                       |
| -------------------------------------- | -------------------------------------------------------- |
| Contrôle strict de la version du CLI   | La taille de `node_modules` augmente                     |
| Version épinglée via `package.json`    | Les mises à jour du CLI doivent être faites manuellement |
| Toute l'équipe utilise la même version | Nécessite un environnement Node.js                       |

## Authentification

La méthode d'authentification est identique quelle que soit la méthode d'installation. Définissez `COPILOT_GITHUB_TOKEN` dans `.env`.

```dotenv theme={null}
COPILOT_GITHUB_TOKEN=your-token
```

Pour plus de détails, voir [Authentification](/fr/packages/laravel-copilot-sdk/auth).

<Info>
  Pour les dernières informations, consultez le [dépôt GitHub](https://github.com/invokable/laravel-copilot-sdk).
</Info>


## Related topics

- [Laravel Boost Custom Agent for GitHub Copilot CLI](/fr/packages/laravel-boost-copilot-cli.md)
- [Plugin Directories](/fr/packages/laravel-copilot-sdk/plugin-directories.md)
- [Télémétrie](/fr/packages/laravel-copilot-sdk/telemetry.md)
- [Authentification - GitHub Copilot SDK pour Laravel](/fr/packages/laravel-copilot-sdk/auth.md)
- [Démarrer - GitHub Copilot SDK pour Laravel](/fr/packages/laravel-copilot-sdk/getting-started.md)