Laravel Boost custom agent for GitHub Copilot CLI

Overview

revolution/laravel-boost-copilot-cli is a package that extends Laravel Boost with a custom agent for the GitHub Copilot CLI. Laravel Boost already ships with a GitHub Copilot agent, but that one is mainly aimed at the GitHub Copilot integration in VS Code. This package clarifies the path for the Copilot CLI and, in particular, provides a setup that plays nicely with package development that uses Testbench.

Requirements

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

Supported platforms

macOS
WSL (native Windows is also possible; WSL recommended)
Linux

Laravel Sail is also usable. Run vendor/bin/sail up -d first, then run the copilot command outside of Sail.

Installation

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

Usage

php artisan boost:install
# Select "GitHub Copilot CLI"
copilot

Guidelines are generated as custom instructions at .github/instructions/laravel-boost.instructions.md. The Copilot CLI automatically loads .github/mcp.json at the project root, so no additional configuration is required.

Customization

Publish config/boost.php to change where the guidelines file and MCP configuration file are generated.

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

Add an agents entry to config/boost.php. To align the Copilot CLI with the official Copilot (VS Code) agent, point it at AGENTS.md. You can also change the Copilot (VS Code) side instead.

'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 is an undocumented feature and may change in future versions.

Testbench support (for package developers)

This package provides a setup that makes Testbench-based workflows — which are hard to cover with the official Laravel Boost — easy to run.

Set up the Testbench workbench

vendor/bin/testbench workbench:install

Add @build to composer.json

Add @build to post-autoload-dump.

{
  "scripts": {
    "post-autoload-dump": [
      "@clear",
      "@prepare",
      "@build"
    ]
  }
}

Install Boost via Testbench

vendor/bin/testbench boost:install

GitHub: invokable/laravel-boost-copilot-cli
Related package for PhpStorm: invokable/laravel-boost-phpstorm-copilot
Copilot SDK for Laravel: invokable/laravel-copilot-sdk

GitHub Copilot

SDK

AI SDK

VOICEVOX

Starter Kits

Feeds and RSS

Middleware

Laravel Boost custom agent for GitHub Copilot CLI

Overview

Requirements

Supported platforms

Installation

Usage

Customization

Testbench support (for package developers)

​Overview

​Requirements

​Supported platforms

​Installation

​Usage

​Customization

​Testbench support (for package developers)

​Related links

Overview

Requirements

Supported platforms

Installation

Usage

Customization

Testbench support (for package developers)

Related links