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

> PhpStorm의 GitHub Copilot 플러그인용으로 Laravel Boost의 커스텀 에이전트를 추가하는 패키지. macOS/Windows/Linux/WSL 지원.

## 패키지 개요

[revolution/laravel-boost-phpstorm-copilot](https://github.com/invokable/laravel-boost-phpstorm-copilot)은 Laravel Boost의 확장으로 **PhpStorm의 GitHub Copilot 플러그인**용 커스텀 에이전트를 추가하는 패키지입니다.

`php artisan boost:install`의 AI 에이전트 선택에 `PhpStorm with GitHub Copilot`이 추가됩니다.

<Warning>
  `PhpStorm`은 `PhpStorm Junie`용 선택지입니다. 반드시 `PhpStorm with GitHub Copilot`을 선택하세요.
</Warning>

## 요구 사항

* PHP 8.3 이상
* Laravel 12 이상
* Laravel Boost 2.0 이상
* PhpStorm에 GitHub Copilot 플러그인을 설치 완료

## 설치

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

## 사용법

<Steps>
  <Step title="Boost 설치 명령어 실행">
    ```shell theme={null}
    php artisan boost:install
    ```
  </Step>

  <Step title="기능 선택">
    `AI Guidelines` / `Agent Skills` / `Boost MCP Server Configuration`에서 필요한 기능을 선택합니다.
  </Step>

  <Step title="AI 에이전트에서 PhpStorm with GitHub Copilot 선택">
    `Which AI agents would you like to configure?`에서 `PhpStorm with GitHub Copilot`을 선택합니다.
  </Step>
</Steps>

## MCP 설정 파일 저장 경로

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

## 중요: 프로젝트 전환 시 재실행 필요

PhpStorm + GitHub Copilot 플러그인에서는 MCP 설정이 **프로젝트 단위가 아니라 시스템 전체**로 저장됩니다.\
설정 파일에는 Laravel 프로젝트의 **절대 경로**가 들어가므로, 프로젝트를 전환할 때마다 갱신이 필요합니다.

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

<Info>
  Boost 1.8 이후의 `boost:update`에서는 MCP 설정 파일이 갱신되지 않습니다.
</Info>

## WSL 지원

이 패키지는 **PhpStorm은 Windows 측, PHP는 WSL 측**에서 실행하는 구성을 지원합니다.

### 요구 사항

* `wslu` 패키지가 필요
* 설치되지 않은 경우에는 `sudo apt install wslu`

### 구조

* `WSL_DISTRO_NAME`으로 WSL 환경을 검출
* `wslvar LOCALAPPDATA`로 Windows 측 AppData 경로를 취득
* PowerShell을 통해 `%LOCALAPPDATA%\github-copilot\intellij\mcp.json`에 기록

### 주의 사항

WSL 안에서 PhpStorm을 원격 개발용으로 사용하는 경우에는 지원 대상이 아닙니다. 필요한 경우에는 MCP 파일을 수동으로 설정하세요.

## Testbench 미지원과 대안

이 패키지는 Testbench에서의 이용을 지원하지 않습니다.\
패키지 개발에서 Testbench를 사용하는 경우에는 대신 [laravel-boost-copilot-cli](https://github.com/invokable/laravel-boost-copilot-cli)를 사용하세요.

## 관련 링크

* [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](/ko/packages/laravel-boost-copilot-cli.md)
- [Boost의 커스텀 에이전트 만들기](/ko/advanced/boost-custom-agent.md)
- [Skills](/ko/packages/laravel-copilot-sdk/skills.md)
- [커스텀 에이전트](/ko/packages/laravel-copilot-sdk/custom-agents.md)
- [인증 - GitHub Copilot SDK for Laravel](/ko/packages/laravel-copilot-sdk/auth.md)