Laravel Boost Custom Agent for GitHub Copilot CLI

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

​

개요

revolution/laravel-boost-copilot-cli는 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 바깥에서 실행합니다.

​

설치

composer require revolution/laravel-boost-copilot-cli --dev

​

사용법

php artisan boost:install
# "GitHub Copilot CLI"를 선택
copilot

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

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

​

커스터마이즈

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

php artisan vendor:publish --tag=boost-config

config/boost.php에 agents를 추가합니다. Copilot CLI를 공식 Copilot(VS Code)과 맞추려면 AGENTS.md를 지정합니다. 반대로 Copilot(VS Code) 측을 변경할 수도 있습니다.

'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',
    ],
],

agents는 문서에 기재되어 있지 않은 기능이므로, 버전 업그레이드에 따라 변경될 가능성이 있습니다.

​

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

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

1. Testbench의 workbench 셋업

   vendor/bin/testbench workbench:install
   
2. composer.json에 @build 추가

   post-autoload-dump에 @build를 추가합니다.

   {
     "scripts": {
       "post-autoload-dump": [
         "@clear",
         "@prepare",
         "@build"
       ]
     }
   }
   
3. Testbench를 통해 Boost 설치

   vendor/bin/testbench boost:install
   

​

관련 링크

• GitHub: invokable/laravel-boost-copilot-cli
• PhpStorm용 관련 패키지: invokable/laravel-boost-phpstorm-copilot
• Copilot SDK for Laravel: invokable/laravel-copilot-sdk