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

> Laravel Boost에 GitHub Copilot CLI용 커스텀 에이전트를 추가하는 패키지. Testbench 대응이 특징입니다.

## 개요

`revolution/laravel-boost-copilot-cli`는 [Laravel Boost](https://github.com/laravel/boost)의 확장으로 GitHub Copilot CLI용 커스텀 에이전트를 추가하는 패키지입니다.

Laravel Boost 본체에도 `GitHub Copilot`이 있지만, 이는 주로 VS Code의 GitHub Copilot 연동용입니다. 이 패키지는 Copilot CLI용 도입 경로를 명확히 하고, 특히 Testbench를 사용하는 패키지 개발에서 다루기 쉬운 구성을 제공합니다.

## 요구 사항

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

## 지원 플랫폼

* macOS
* WSL(Native Windows도 가능. WSL 권장)
* Linux

Laravel Sail도 이용할 수 있습니다. 먼저 `vendor/bin/sail up -d`를 실행하고, `copilot` 명령어는 Sail 바깥에서 실행합니다.

## 설치

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

## 사용법

```shell theme={null}
php artisan boost:install
# "GitHub Copilot CLI"를 선택
copilot
```

가이드라인은 커스텀 인스트럭션으로서 `.github/instructions/laravel-boost.instructions.md`에 생성됩니다.

Copilot CLI는 프로젝트 루트의 `.github/mcp.json`을 자동으로 읽어들이므로, 추가 설정은 불필요합니다.

## 커스터마이즈

`config/boost.php`를 공개함으로써 가이드라인 파일이나 MCP 설정 파일의 생성 경로를 변경할 수 있습니다.

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

`config/boost.php`에 `agents`를 추가합니다. Copilot CLI를 공식 Copilot(VS Code)과 맞추려면 `AGENTS.md`를 지정합니다. 반대로 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`는 문서에 기재되어 있지 않은 기능이므로, 버전 업그레이드에 따라 변경될 가능성이 있습니다.
</Warning>

## Testbench 대응(패키지 개발자용)

이 패키지는 Laravel Boost 공식으로는 커버하기 어려운 Testbench 전제의 운용에 대응하기 쉬운 구성을 제공합니다.

<Steps>
  <Step title="Testbench의 workbench 셋업">
    ```shell theme={null}
    vendor/bin/testbench workbench:install
    ```
  </Step>

  <Step title="composer.json에 @build 추가">
    `post-autoload-dump`에 `@build`를 추가합니다.

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

  <Step title="Testbench를 통해 Boost 설치">
    ```shell theme={null}
    vendor/bin/testbench boost:install
    ```
  </Step>
</Steps>

## 관련 링크

* GitHub: [invokable/laravel-boost-copilot-cli](https://github.com/invokable/laravel-boost-copilot-cli)
* 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](/ko/packages/laravel-boost-phpstorm-copilot.md)
- [인증 - GitHub Copilot SDK for Laravel](/ko/packages/laravel-copilot-sdk/auth.md)
- [Laravel Cloud - GitHub Copilot SDK for Laravel](/ko/packages/laravel-copilot-sdk/laravel-cloud.md)
- [GitHub Actions - GitHub Copilot SDK for Laravel](/ko/packages/laravel-copilot-sdk/github-actions.md)
- [시작하기 - GitHub Copilot SDK for Laravel](/ko/packages/laravel-copilot-sdk/getting-started.md)