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

# Laravel Boost Custom Agent for GitHub Copilot CLI

> Package qui ajoute un agent personnalisé pour GitHub Copilot CLI à Laravel Boost. Prise en charge de Testbench en particulier.

## Vue d'ensemble

`revolution/laravel-boost-copilot-cli` est un package qui étend [Laravel Boost](https://github.com/laravel/boost) en ajoutant un agent personnalisé pour GitHub Copilot CLI.

Laravel Boost inclut aussi `GitHub Copilot`, mais celui-ci est principalement destiné à l'intégration GitHub Copilot dans VS Code. Ce package clarifie le parcours pour Copilot CLI et fournit une configuration facilement exploitable, en particulier pour le développement de packages utilisant Testbench.

## Prérequis

* PHP 8.2+
* Laravel 12+
* Laravel Boost 2.0+
* Copilot CLI 1.0.61+

## Plateformes prises en charge

* macOS
* WSL (Windows natif également possible. WSL recommandé)
* Linux

Laravel Sail est également utilisable. Exécutez d'abord `vendor/bin/sail up -d`, puis lancez la commande `copilot` en dehors de Sail.

## Installation

```shell theme={null}
composer require revolution/laravel-boost-copilot-cli --dev
```

## Utilisation

```shell theme={null}
php artisan boost:install
# Sélectionnez "GitHub Copilot CLI"
copilot
```

Les guidelines sont générées dans `.github/instructions/laravel-boost.instructions.md` sous forme d'instructions personnalisées.

Copilot CLI lit automatiquement le fichier `.github/mcp.json` à la racine du projet, aucune configuration supplémentaire n'est nécessaire.

## Personnalisation

En publiant `config/boost.php`, vous pouvez modifier les chemins de génération des fichiers de guidelines et de configuration MCP.

```shell theme={null}
php artisan vendor:publish --tag=boost-config
```

Ajoutez `agents` dans `config/boost.php`. Pour aligner Copilot CLI sur Copilot officiel (VS Code), spécifiez `AGENTS.md`. Vous pouvez aussi, à l'inverse, modifier le côté Copilot (VS Code).

```php theme={null}
'executable_paths' => [],

'agents' => [
    // Copilot CLI
    'copilot_cli' => [
        'guidelines_path' => 'AGENTS.md',
        'mcp_config_path' => '.github/mcp.json',
    ],
    // Copilot (VS Code)
    'copilot' => [
        'guidelines_path' => '.github/instructions/laravel-boost.instructions.md',
        'mcp_config_path' => '.vscode/mcp.json',
    ],
],
```

<Warning>
  `agents` est une fonctionnalité non documentée. Elle peut donc changer lors des mises à jour de version.
</Warning>

## Prise en charge de Testbench (pour les développeurs de packages)

Ce package fournit une configuration facilement exploitable pour un usage avec Testbench, difficile à couvrir avec Laravel Boost officiel.

<Steps>
  <Step title="Configurer le workbench de Testbench">
    ```shell theme={null}
    vendor/bin/testbench workbench:install
    ```
  </Step>

  <Step title="Ajouter @build dans composer.json">
    Ajoutez `@build` à `post-autoload-dump`.

    ```json theme={null}
    {
      "scripts": {
        "post-autoload-dump": [
          "@clear",
          "@prepare",
          "@build"
        ]
      }
    }
    ```
  </Step>

  <Step title="Installer Boost via Testbench">
    ```shell theme={null}
    vendor/bin/testbench boost:install
    ```
  </Step>
</Steps>

## Liens connexes

* GitHub : [invokable/laravel-boost-copilot-cli](https://github.com/invokable/laravel-boost-copilot-cli)
* Package associé pour PhpStorm : [invokable/laravel-boost-phpstorm-copilot](https://github.com/invokable/laravel-boost-phpstorm-copilot)
* Copilot SDK for Laravel : [invokable/laravel-copilot-sdk](https://github.com/invokable/laravel-copilot-sdk)


## Related topics

- [Laravel Boost Custom Agent for PhpStorm with GitHub Copilot](/fr/packages/laravel-boost-phpstorm-copilot.md)
- [Authentification - GitHub Copilot SDK pour Laravel](/fr/packages/laravel-copilot-sdk/auth.md)
- [Laravel Cloud - GitHub Copilot SDK pour Laravel](/fr/packages/laravel-copilot-sdk/laravel-cloud.md)
- [GitHub Actions - GitHub Copilot SDK pour Laravel](/fr/packages/laravel-copilot-sdk/github-actions.md)
- [Démarrer - GitHub Copilot SDK pour Laravel](/fr/packages/laravel-copilot-sdk/getting-started.md)