> ## 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 PhpStorm with GitHub Copilot

> Package qui ajoute un agent personnalisé Laravel Boost pour le plugin GitHub Copilot de PhpStorm. Compatible macOS/Windows/Linux/WSL.

## Vue d'ensemble du package

[revolution/laravel-boost-phpstorm-copilot](https://github.com/invokable/laravel-boost-phpstorm-copilot) est un package qui étend Laravel Boost en ajoutant un agent personnalisé pour **le plugin GitHub Copilot de PhpStorm**.

`PhpStorm with GitHub Copilot` est ajouté à la sélection d'agents IA de `php artisan boost:install`.

<Warning>
  `PhpStorm` est le choix destiné à `PhpStorm Junie`. Assurez-vous de sélectionner `PhpStorm with GitHub Copilot`.
</Warning>

## Prérequis

* PHP 8.3 ou supérieur
* Laravel 12 ou supérieur
* Laravel Boost 2.0 ou supérieur
* Plugin GitHub Copilot installé dans PhpStorm

## Installation

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

## Utilisation

<Steps>
  <Step title="Exécuter la commande d'installation de Boost">
    ```shell theme={null}
    php artisan boost:install
    ```
  </Step>

  <Step title="Sélectionner les fonctionnalités">
    Choisissez les fonctionnalités nécessaires parmi `AI Guidelines` / `Agent Skills` / `Boost MCP Server Configuration`.
  </Step>

  <Step title="Sélectionner PhpStorm with GitHub Copilot comme agent IA">
    Sélectionnez `PhpStorm with GitHub Copilot` à la question `Which AI agents would you like to configure?`.
  </Step>
</Steps>

## Emplacement du fichier de configuration MCP

| OS           | Chemin                                            |
| ------------ | ------------------------------------------------- |
| macOS, Linux | `~/.config/github-copilot/intellij/mcp.json`      |
| Windows      | `%LOCALAPPDATA%\github-copilot\intellij\mcp.json` |

## Important : réexécution nécessaire au changement de projet

Avec PhpStorm + plugin GitHub Copilot, la configuration MCP est enregistrée **au niveau du système entier et non par projet**.\
Le fichier de configuration contenant le **chemin absolu** du projet Laravel, une mise à jour est nécessaire à chaque changement de projet.

```shell theme={null}
php artisan boost:install --guidelines --skills --mcp --no-interaction
```

<Info>
  Depuis Boost 1.8, `boost:update` ne met plus à jour le fichier de configuration MCP.
</Info>

## Prise en charge de WSL

Ce package prend en charge une configuration où **PhpStorm tourne côté Windows et PHP côté WSL**.

### Prérequis

* Le paquet `wslu` est nécessaire
* S'il n'est pas installé : `sudo apt install wslu`

### Fonctionnement

* Détection de l'environnement WSL via `WSL_DISTRO_NAME`
* Récupération du chemin AppData côté Windows via `wslvar LOCALAPPDATA`
* Écriture de `%LOCALAPPDATA%\github-copilot\intellij\mcp.json` via PowerShell

### Points d'attention

L'utilisation de PhpStorm à l'intérieur de WSL en mode développement à distance n'est pas prise en charge. Si nécessaire, configurez manuellement le fichier MCP.

## Non-support de Testbench et alternative

Ce package ne prend pas en charge l'utilisation avec Testbench.\
Pour le développement de packages avec Testbench, utilisez plutôt [laravel-boost-copilot-cli](https://github.com/invokable/laravel-boost-copilot-cli).

## Liens connexes

* [laravel-boost-phpstorm-copilot (GitHub)](https://github.com/invokable/laravel-boost-phpstorm-copilot)
* [Laravel Boost (GitHub)](https://github.com/laravel/boost)
* [GitHub Copilot plugin for PhpStorm](https://plugins.jetbrains.com/plugin/17718-github-copilot)


## Related topics

- [Laravel Boost Custom Agent for GitHub Copilot CLI](/fr/packages/laravel-boost-copilot-cli.md)
- [Créer un agent personnalisé pour Boost](/fr/advanced/boost-custom-agent.md)
- [Agents personnalisés](/fr/packages/laravel-copilot-sdk/custom-agents.md)
- [Skills](/fr/packages/laravel-copilot-sdk/skills.md)
- [Laravel Agent Detector — package de détection d'agents IA](/fr/blog/agent-detector-introduction.md)