Reference

This section provides quick-reference material for the revolution/laravel-boost-copilot-cli package: its dependencies, configuration files, Artisan and Composer commands, troubleshooting guidance, version control configuration, and license. For conceptual explanations of how these pieces fit together, see Core Architecture and Configuration System.

---

Section Map

Page	Title	What You'll Find
7.1	Package Dependencies	Runtime and dev dependency list with version constraints
7.2	Configuration Files Reference	Every config file in the repo described in one place
7.3	Command Reference	All Artisan commands, Composer scripts, and copilot invocations
7.4	Troubleshooting	Known issues, workarounds, and environment-specific fixes
7.5	Version Control Configuration	.gitattributes export-ignore rules and .gitignore entries
7.6	License	MIT license terms and copyright

---

Key Code Entities at a Glance

Primary source files

Symbol	File	Role
CopilotCli	src/CopilotCli.php	Core agent class; implements Agent, SupportsGuidelines, SupportsMcp, SupportsSkills interfaces
CopilotCliServiceProvider	src/CopilotCliServiceProvider.php	Registers the agent via Boost::registerAgent() and fixes Testbench root path
core.blade.php	resources/boost/guidelines/core.blade.php	Guideline template distributed to package users via boost:install
copilot-cli.blade.php	.ai/guidelines/copilot-cli.blade.php	Guideline template used during package development

Generated output files

File	Created By	Purpose
.github/mcp-config.json	boost:install	MCP server configuration: defines mcpServers.laravel-boost with command, args, and tools
.github/mcp-config.local.json	Developer (manual)	Local-only credentials, never committed (in .gitignore)
.github/instructions/laravel-boost.instructions.md	boost:install	AI guideline instructions for Copilot CLI, rendered from core.blade.php
.github/skills/pest-testing/SKILL.md	boost:install	Pest testing agent skill definition
.github/copilot-instructions.md	Developer (manual/workaround)	Workaround for Copilot CLI < character parser bug
boost.json	boost:install	Records selected agents, skills, and feature flags

Sources: src/CopilotCli.php src/CopilotCliServiceProvider.php resources/boost/guidelines/core.blade.php .ai/guidelines/copilot-cli.blade.php

---

Component Relationship Diagram

Diagram: Key Code Entities and Their Relationships

Sources: src/CopilotCli.php src/CopilotCliServiceProvider.php </old_str> <new_str>

Component Relationship Diagram

Diagram: Key Code Entities and Their Relationships

Sources: src/CopilotCli.php src/CopilotCliServiceProvider.php

---

Component Relationship Diagram

Diagram: Key Code Entities and Their Relationships

Sources: src/CopilotCli.php src/CopilotCliServiceProvider.php README.md1-133

---

Command Summary

A full reference with all options appears in 7.3 Command Reference. The most frequently used commands:

Command	Context	Effect
composer require revolution/laravel-boost-copilot-cli --dev	Shell	Installs the package
php artisan boost:install	Laravel app	Generates .github/ config files interactively
vendor/bin/testbench boost:install	Package dev	Generates config files for Testbench environment
copilot --additional-mcp-config @.github/mcp-config.json	Shell	Starts Copilot CLI with MCP server attached
composer test	Shell	Runs pest --compact test suite
composer lint	Shell	Runs pint code formatter
composer boost	Package dev	Runs vendor/bin/testbench boost:install --no-interaction --ansi
composer build	Package dev	Runs vendor/bin/testbench workbench:build --ansi

---

Composer Scripts Reference

The package defines several Composer scripts for development workflow. These are defined in composer.json53-76:

Script	Composer Command	Actual Command	Purpose
test	composer test	pest --compact	Run Pest test suite with compact output
test:coverage	composer test:coverage	pest --compact --coverage --coverage-clover build/logs/clover.xml	Run tests with coverage report
lint	composer lint	pint	Format code with Laravel Pint
test:lint	composer test:lint	pint --test	Check code formatting without changes
boost	composer boost	vendor/bin/testbench boost:install --no-interaction --ansi	Run boost:install in Testbench non-interactively
clear	composer clear	vendor/bin/testbench package:purge-skeleton --ansi	Purge package skeleton files
prepare	composer prepare	vendor/bin/testbench package:discover --ansi	Discover packages
build	composer build	vendor/bin/testbench workbench:build --ansi	Build workbench environment
serve	composer serve	vendor/bin/testbench serve --ansi	Start Testbench development server
post-autoload-dump	(automatic)	@clear, @prepare, @build	Automatically runs after composer dump-autoload

Sources: composer.json53-76

---

MCP Server Config Structure (Quick Reference)

A full description of each field is in 7.2 Configuration Files Reference. The core structure written by CopilotCli::mcpServerConfig():

.github/mcp-config.json
└── mcpServers
 └── laravel-boost
 ├── type → "local"
 ├── command → "php" | "./vendor/bin/sail" | "./vendor/bin/testbench"
 ├── args → ["artisan", "boost:mcp"] or ["boost:mcp"]
 ├── env → {} (may include TESTBENCH_CORE for Testbench)
 └── tools → ["*"]

The command value is determined by CopilotCli::convertCommandToPhpPath() based on the detected environment. See 5.4 Environment Detection and Adaptation for the full decision tree.

---

Environment Detection Quick Reference

Condition Checked	Detection Method	Implementation	Result
TESTBENCH_CORE constant defined	defined('TESTBENCH_CORE') in isRunningInTestbench()	src/CopilotCli.php	Command: ./vendor/bin/testbench, Args: ['boost:mcp'], Env: ['TESTBENCH_CORE' => '1']
WSL_DISTRO_NAME or IS_WSL env var set	getenv('WSL_DISTRO_NAME') or getenv('IS_WSL') in isRunningInsideWsl()	src/CopilotCli.php	Uses getPhpPath() from base Agent class (converts to Windows path)
Command string ends with 'sail'	str_ends_with($command, 'sail') check	src/CopilotCli.php	Command: ./vendor/bin/sail, Args: ['artisan', 'boost:mcp']
None of the above	Default case	src/CopilotCli.php	Command: as-is (e.g. php), Args: ['artisan', 'boost:mcp']

Environment-specific MCP config examples:

Sources: src/CopilotCli.php

---

Diagram: Command-to-File Resolution

Diagram: How boost:install Resolves to Output Files

Sources: README.md43-53 src/CopilotCli.php

---

For in-depth explanations of any of these topics, navigate to the relevant child page using the section map at the top of this page.