# Laravel Boost

> Setup and manage Laravel Boost for AI-assisted development with guidelines, skills, MCP server, and documentation API.

- Skill: `joaopaulolndev/laravel-boost` (Agent Skill)
- Install (CLI): `npx skillmds@latest add joaopaulolndev/laravel-boost`
- Raw SKILL.md: https://api.skillmd.com/api/skills/joaopaulolndev/laravel-boost/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: joaopaulolndev (https://skillmd.com/u/joaopaulolndev)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/joaopaulolndev/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:

```bash
# 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

```bash
# 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

```bash
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

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

### Gemini CLI

```bash
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

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

## Keeping Resources Updated

```bash
# Update local Boost resources
php artisan boost:update
```

### Automate via Composer

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

## MCP Server Tools

| Tool | Description |
|------|-------------|
| Application Info | PHP & Laravel versions, database, packages, models |
| Browser Logs | Read logs and errors from browser |
| Database Connections | Inspect available connections |
| Database Query | Execute queries against the database |
| Database Schema | Read database schema |
| Get Absolute URL | Convert relative URIs to absolute paths |
| Get Config | Get config values using dot notation |
| Last Error | Read last error from application logs |
| List Artisan Commands | Inspect available Artisan commands |
| List Available Config Keys | Inspect configuration keys |
| List Available Env Vars | Inspect environment variable keys |
| List Routes | Inspect application routes |
| Read Log Entries | Read last N log entries |
| Search Docs | Query Laravel documentation API |
| Tinker | Execute arbitrary code within application context |

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

| Package | Versions |
|---------|----------|
| Core & Boost | core |
| Laravel Framework | core, 10.x, 11.x, 12.x |
| Livewire | core, 2.x, 3.x, 4.x |
| Flux UI | core, free, pro |
| Folio | core |
| Inertia (React/Vue/Svelte) | core, 1.x, 2.x |
| Pennant | core |
| Pest | core, 3.x, 4.x |
| PHPUnit | core |
| Pint | core |
| Tailwind CSS | core, 3.x, 4.x |
| Livewire Volt | core |
| Wayfinder | core |

## Available Built-in Skills

| Skill | Package |
|-------|---------|
| fluxui-development | Flux UI |
| folio-routing | Folio |
| inertia-react-development | Inertia React |
| inertia-svelte-development | Inertia Svelte |
| inertia-vue-development | Inertia Vue |
| livewire-development | Livewire |
| mcp-development | MCP |
| pennant-development | Pennant |
| pest-testing | Pest |
| tailwindcss-development | Tailwind CSS |
| volt-development | Volt |
| wayfinder-development | Wayfinder |

## Guidelines vs Skills

| Aspecto | Guidelines | Skills |
|---------|-----------|--------|
| **Carregado** | Upfront, sempre presente | On-demand, quando relevante |
| **Escopo** | Amplo, fundacional | Focado, task-specific |
| **Propósito** | Convenções e best practices | Padroes de implementacao detalhados |

## Documentation API

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

### Supported Packages

| Package | Versions |
|---------|----------|
| Laravel Framework | 10.x, 11.x, 12.x |
| Filament | 2.x, 3.x, 4.x, 5.x |
| Flux UI | 2.x Free, 2.x Pro |
| Inertia | 1.x, 2.x |
| Livewire | 1.x, 2.x, 3.x, 4.x |
| Nova | 4.x, 5.x |
| Pest | 3.x, 4.x |
| Tailwind CSS | 3.x, 4.x |

## Windows-Specific Notes

### Use Herd PHP paths

```bash
"$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

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

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

### 2. Update (ALWAYS - every session)

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

### 3. Configure MCP Server

```bash
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

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

## Reference Files

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