> ## 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

> Paquete que añade un agente personalizado de Laravel Boost al plugin de GitHub Copilot para PhpStorm. Compatible con macOS/Windows/Linux/WSL.

## Descripción del paquete

[revolution/laravel-boost-phpstorm-copilot](https://github.com/invokable/laravel-boost-phpstorm-copilot) es un paquete que, como extensión de Laravel Boost, añade un agente personalizado para el **plugin de GitHub Copilot en PhpStorm**.

En la selección de agentes de IA de `php artisan boost:install` aparece `PhpStorm with GitHub Copilot`.

<Warning>
  La opción `PhpStorm` está pensada para `PhpStorm Junie`. Asegúrate de elegir `PhpStorm with GitHub Copilot`.
</Warning>

## Requisitos

* PHP 8.3 o superior
* Laravel 12 o superior
* Laravel Boost 2.0 o superior
* Tener instalado el plugin de GitHub Copilot en PhpStorm

## Instalación

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

## Uso

<Steps>
  <Step title="Ejecuta el comando de instalación de Boost">
    ```shell theme={null}
    php artisan boost:install
    ```
  </Step>

  <Step title="Selecciona las funcionalidades">
    Selecciona las funcionalidades que necesites entre `AI Guidelines`, `Agent Skills` y `Boost MCP Server Configuration`.
  </Step>

  <Step title="En agentes de IA, elige PhpStorm with GitHub Copilot">
    En `Which AI agents would you like to configure?` selecciona `PhpStorm with GitHub Copilot`.
  </Step>
</Steps>

## Ubicación del archivo de configuración MCP

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

## Importante: hay que reejecutar al cambiar de proyecto

Con PhpStorm + el plugin de GitHub Copilot, la configuración MCP se guarda **a nivel de sistema, no por proyecto**.\
El archivo contiene la **ruta absoluta** del proyecto Laravel, así que cada vez que cambies de proyecto tendrás que actualizarlo.

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

<Info>
  Desde Boost 1.8, `boost:update` no actualiza el archivo de configuración MCP.
</Info>

## Compatibilidad con WSL

Este paquete admite el escenario en el que **PhpStorm está en Windows y PHP se ejecuta en WSL**.

### Requisitos

* Se necesita el paquete `wslu`
* Si no lo tienes instalado: `sudo apt install wslu`

### Cómo funciona

* Detecta el entorno WSL mediante `WSL_DISTRO_NAME`
* Obtiene la ruta AppData de Windows con `wslvar LOCALAPPDATA`
* Escribe `%LOCALAPPDATA%\github-copilot\intellij\mcp.json` a través de PowerShell

### Consideraciones

Si usas PhpStorm dentro de WSL como desarrollo remoto, no está soportado. En ese caso, configura manualmente el archivo MCP.

## No compatible con Testbench y alternativa

Este paquete no admite el uso con Testbench.\
Si vas a usar Testbench para desarrollo de paquetes, utiliza en su lugar [laravel-boost-copilot-cli](https://github.com/invokable/laravel-boost-copilot-cli).

## Enlaces relacionados

* [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](/es/packages/laravel-boost-copilot-cli.md)
- [Crear un agente personalizado de Boost](/es/advanced/boost-custom-agent.md)
- [Skills](/es/packages/laravel-copilot-sdk/skills.md)
- [Agentes personalizados](/es/packages/laravel-copilot-sdk/custom-agents.md)
- [Autenticación - GitHub Copilot SDK for Laravel](/es/packages/laravel-copilot-sdk/auth.md)