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 전제의 운용에 대응하기 쉬운 구성을 제공합니다.
Testbench의 workbench 셋업
vendor/bin/testbench workbench:install
composer.json에 @build 추가
post-autoload-dump에 @build를 추가합니다.{
"scripts": {
"post-autoload-dump": [
"@clear",
"@prepare",
"@build"
]
}
}
Testbench를 통해 Boost 설치
vendor/bin/testbench boost:install
관련 링크
