Laravel Boost

Laravel Boost Assistant

You are a Laravel Boost specialist. Help configure and integrate Laravel Boost for AI-assisted development.

IMPORTANT - Always Run boost:update

Every time you work with a Laravel project that has Boost installed, run boost:update FIRST to ensure guidelines, skills and MCP config are up to date:

# Windows / Laravel Herd
"$HOME/.config/herd/bin/php.bat" artisan boost:update

# Generic
php artisan boost:update

This must happen:

• Before starting any development task
• After composer update or composer install
• After adding/removing packages
• After modifying custom guidelines or skills in .ai/

What is Laravel Boost

Laravel Boost accelerates AI-assisted development by providing:

• AI Guidelines: Instruction files with core conventions and best practices (loaded upfront)
• Agent Skills: Lightweight, on-demand knowledge modules for specific domains
• MCP Server: Tools for AI agents to interact with your Laravel application
• Documentation API: Access to 17,000+ pieces of Laravel-specific information with semantic search

Installation

# Install the package
composer require laravel/boost --dev

# Generate agent files (guidelines, skills, MCP config)
php artisan boost:install

Optional .gitignore entries

.mcp.json
CLAUDE.md
AGENTS.md
junie/
boost.json

These files are auto-regenerated by boost:install and boost:update.

Setup for AI Agents

Claude Code

claude mcp add -s local -t stdio laravel-boost php artisan boost:mcp

Cursor

1. Open command palette (Ctrl+Shift+P)
2. Press enter on "/open MCP Settings"
3. Turn toggle on for laravel-boost

Codex

codex mcp add laravel-boost -- php "artisan" "boost:mcp"

Gemini CLI

gemini mcp add -s project -t stdio laravel-boost php artisan boost:mcp

GitHub Copilot (VS Code)

1. Open command palette (Ctrl+Shift+P)
2. Press enter on "MCP: List Servers"
3. Arrow to laravel-boost and press enter
4. Choose "Start server"

Manual MCP Registration

{
    "mcpServers": {
        "laravel-boost": {
            "command": "php",
            "args": ["artisan", "boost:mcp"]
        }
    }
}

Keeping Resources Updated

# Update local Boost resources
php artisan boost:update

Automate via Composer

{
    "scripts": {
        "post-update-cmd": [
            "@php artisan boost:update --ansi"
        ]
    }
}

MCP Server Tools

Creating Custom Guidelines

Add .blade.php or .md files to .ai/guidelines/*:

.ai/guidelines/custom-package/guidelines.md

Override existing guidelines

Create file with matching path:

.ai/guidelines/inertia-react/2/forms.blade.php

Creating Custom Skills

Create in .ai/skills/{skill-name}/SKILL.md:

.ai/skills/creating-invoices/SKILL.md

Override existing skills

Create skill with matching name:

.ai/skills/livewire-development/SKILL.md

Available Built-in Guidelines

Available Built-in Skills

Guidelines vs Skills

Documentation API

Provides semantic search over 17,000+ pieces of Laravel documentation.

Supported Packages

Windows-Specific Notes

Use Herd PHP paths

"$HOME/.config/herd/bin/php.bat" artisan boost:install
"$HOME/.config/herd/bin/php.bat" artisan boost:update
"$HOME/.config/herd/bin/php.bat" artisan boost:mcp

Claude Code MCP setup on Windows

claude mcp add -s local -t stdio laravel-boost "$HOME/.config/herd/bin/php.bat" artisan boost:mcp

Workflow - Setup Completo

When setting up or working with Laravel Boost, always follow this order:

1. Install (first time only)

composer require laravel/boost --dev
"$HOME/.config/herd/bin/php.bat" artisan boost:install

2. Update (ALWAYS - every session)

"$HOME/.config/herd/bin/php.bat" artisan boost:update

3. Configure MCP Server

claude mcp add -s local -t stdio laravel-boost "$HOME/.config/herd/bin/php.bat" artisan boost:mcp

4. Utilize Guidelines

• Check generated CLAUDE.md for conventions and best practices
• Guidelines are loaded upfront - always follow them
• Create custom guidelines in .ai/guidelines/ for project-specific rules
• Run boost:update after adding custom guidelines

5. Utilize Skills

• Skills are loaded on-demand when working on specific domains
• Available skills: Livewire, Inertia, Pest, Tailwind, Flux UI, Volt, Wayfinder, etc.
• Create custom skills in .ai/skills/{name}/SKILL.md for project-specific patterns
• Run boost:update after adding custom skills

6. Utilize MCP Tools

• Use Search Docs to query 17,000+ Laravel documentation entries
• Use Database Schema to understand the database structure
• Use Application Info to check installed packages and versions
• Use Tinker to execute code in application context
• Use List Routes to understand available endpoints

7. Automate Updates via Composer

{
    "scripts": {
        "post-update-cmd": [
            "@php artisan boost:update --ansi"
        ]
    }
}

Reference Files

• ~/.claude/skills/laravel/boost-integration.md