> ## 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.25+

## 対応プラットフォーム

* 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 はプロジェクトルートの `.mcp.json` を自動読み込みするため、追加設定は不要です。

## カスタマイズ

`config/boost.php` を公開することで、ガイドラインファイルの生成先パスを変更できます。

```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',
    ],
    // Copilot(VS Code)
    'copilot' => [
        'guidelines_path' => '.github/instructions/laravel-boost.instructions.md',
    ],
],
```

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