Configuration Reference

This section documents every configuration file in the revolution/laravel-boost-phpstorm-copilot package and the files it installs into a consuming Laravel project. It covers how each file is structured, what fields are valid, and which runtime components read them.

This page is a section index. It describes where each configuration file fits in the overall system. For detailed method-level API documentation on the classes that consume these files, see API Reference. For the installation workflow that writes some of these files, see Initial Configuration with boost:install.

---

Configuration Files at a Glance

The package involves two categories of configuration files:

Category	File	Scope	Purpose
Package metadata	composer.json	Package	PHP/Laravel version constraints, dependencies, autoloading, scripts
Boost agent config	boost.json	Project	Feature flags and agent registration for laravel/boost
Runtime MCP config	mcp.json	System-wide	Tells PhpStorm's Copilot plugin how to start the MCP subprocess
Dev-time MCP config	.github/mcp-config.json	Dev only	Testbench-based local MCP server for package development
Test runner config	phpunit.xml	Dev only	PHPUnit/Pest suite definition, bootstrap, env vars, coverage
Testbench config	testbench.yaml	Dev only	Orchestra Testbench workbench configuration
Code style config	pint.json	Dev only	Laravel Pint rules applied during linting
Editor config	.editorconfig	Dev only	Whitespace, encoding, and indentation rules
Git attributes	.gitattributes	Dev only	Export-ignore list, diff strategies

---

How Configuration Files Relate to System Stages

Configuration files used at each lifecycle stage:

Sources: composer.json1-84 boost.json1-16 .github/mcp-config.json1-14

---

Configuration File Ownership

Some files are owned by the package itself; others are written into the developer's project or the developer's operating system during installation.

Sources: composer.json47-52 boost.json1-16

---

Sub-Page Guide

Each sub-page in this section provides a full field-by-field reference for its configuration file(s):

Sub-page	Files Covered	Key Topics
Package Configuration (composer.json)	composer.json	Version constraints, PSR-4 autoload map, extra.laravel.providers, composer scripts
Boost Configuration (boost.json)	boost.json, .github/mcp-config.json	Agent feature flags (mcp, guidelines, skills, sail), dev MCP server schema
MCP Configuration Format and Examples	mcp.json (generated)	servers key schema, command/args fields, per-OS annotated examples
Testing Configuration	phpunit.xml, testbench.yaml	Feature testsuite path, bootstrap, env vars, coverage source, workbench build steps
Code Quality Configuration	pint.json, .editorconfig, .gitattributes	Pint preset and rule overrides, indentation/encoding rules, export-ignore entries

---

Quick Reference: boost.json Fields

boost.json is the primary control surface that determines which features php artisan boost:install activates for this agent. The file at boost.json1-16 contains:

Field	Type	Value in This Repo	Effect
agents	array	["copilot-cli"]	Additional agents to install alongside this one
guidelines	bool	true	Installs the AI guidelines instruction file
mcp	bool	true	Installs PhpStorm Copilot MCP server config
herd_mcp	bool	false	Installs Laravel Herd MCP config (disabled)
nightwatch_mcp	bool	false	Installs Nightwatch MCP config (disabled)
sail	bool	false	Applies Sail-specific MCP command wrapping
packages	array	["revolution/laravel-boost-copilot-cli"]	Companion packages installed with agent
skills	array	["pest-testing"]	Skill files to publish into .github/skills/

---

Quick Reference: .github/mcp-config.json

Used only during package development (not installed into consuming projects). Defines a testbench-backed MCP server for use in the package's own development environment.

From .github/mcp-config.json1-14:

Field	Value	Description
mcpServers.laravel-boost.type	"local"	MCP server type
mcpServers.laravel-boost.command	"./vendor/bin/testbench"	Testbench binary (relative path)
mcpServers.laravel-boost.args	["boost:mcp"]	Artisan command served over MCP
mcpServers.laravel-boost.tools	["*"]	Exposes all MCP tools

Note: This file uses relative paths because it is used only in the development workbench, not by an end-user's PhpStorm. The system-wide mcp.json that PhpStormCopilot::installFileMcp() writes always uses absolute paths. See MCP Configuration Format and Examples for details.

Sources: .github/mcp-config.json1-14 boost.json1-16