> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Laravel Boost

> Laravel Boost accélère le développement assisté par IA : MCP, guidelines IA, Agent Skills — pour que votre agent comprenne en profondeur votre application Laravel.

## Introduction

Laravel Boost est un package qui accélère le développement assisté par IA en fournissant les guidelines et les Agent Skills nécessaires pour que l'agent produise du code Laravel de qualité, conforme aux bonnes pratiques.

Boost fournit aussi une API documentaire puissante avec plus de 17 000 pages d'informations propres à Laravel et une recherche sémantique basée sur les embeddings. Boost indique aux agents (Claude Code, Cursor…) d'utiliser cette API pour rester à jour sur les dernières fonctionnalités et bonnes pratiques.

## Installation

```shell theme={null}
composer require laravel/boost --dev
```

Ensuite, installez le serveur MCP et les guidelines :

```shell theme={null}
php artisan boost:install
```

`boost:install` génère guidelines et fichiers Skills pour l'agent choisi.

Une fois terminé, vous pouvez commencer à coder avec Cursor, Claude Code ou votre agent IA préféré.

<Note>
  Les fichiers générés (`.mcp.json`, `CLAUDE.md`, `AGENTS.md`, `junie/`, `boost.json`…) peuvent être ajoutés au `.gitignore`. Ils sont regénérés par `boost:install` / `boost:update`.
</Note>

### Configuration par agent

<Tabs>
  <Tab title="Cursor">
    1. Ouvrez la palette de commandes (`Cmd+Shift+P` / `Ctrl+Shift+P`)
    2. Choisissez « /open MCP Settings » puis `Enter`
    3. Activez le toggle `laravel-boost`
  </Tab>

  <Tab title="Claude Code">
    Généralement automatique. Sinon :

    ```shell theme={null}
    claude mcp add -s local -t stdio laravel-boost php artisan boost:mcp
    ```
  </Tab>

  <Tab title="Codex">
    Généralement automatique. Sinon :

    ```shell theme={null}
    codex mcp add laravel-boost -- php "artisan" "boost:mcp"
    ```
  </Tab>

  <Tab title="Gemini CLI">
    Généralement automatique. Sinon :

    ```shell theme={null}
    gemini mcp add -s project -t stdio laravel-boost php artisan boost:mcp
    ```
  </Tab>

  <Tab title="GitHub Copilot (VS Code)">
    1. Palette de commandes (`Cmd+Shift+P` / `Ctrl+Shift+P`)
    2. « MCP: List Servers » puis `Enter`
    3. Sélectionnez `laravel-boost` puis `Enter`
    4. « Start server »
  </Tab>

  <Tab title="Junie">
    1. Appuyez deux fois sur `Shift` pour la palette
    2. Cherchez « MCP Settings »
    3. Cochez `laravel-boost`
    4. « Apply »
  </Tab>
</Tabs>

### Mise à jour des ressources Boost

Mettez à jour périodiquement pour refléter les dernières versions des packages installés.

```shell theme={null}
php artisan boost:update
```

Vous pouvez l'automatiser via `post-update-cmd` de Composer.

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

Par défaut, seules les ressources déjà publiées sont mises à jour. Pour détecter les nouveaux packages et proposer leurs guidelines/skills, utilisez `--discover`.

```shell theme={null}
php artisan boost:update --discover
```

## Serveur MCP

Le serveur MCP fournit à l'agent des outils pour interagir avec l'application : inspection, requêtes DB, exécution de code…

### Outils disponibles

| Outil                | Description                                                       |
| -------------------- | ----------------------------------------------------------------- |
| Application Info     | Versions PHP/Laravel, DB, packages, modèles Eloquent              |
| Browser Logs         | Logs et erreurs du navigateur                                     |
| Database Connections | Connexions disponibles (dont défaut)                              |
| Database Query       | Exécution de requêtes                                             |
| Database Schema      | Lecture du schéma                                                 |
| Get Absolute URL     | Convertit une URI relative en URL absolue                         |
| Last Error           | Dernière erreur dans les logs                                     |
| Read Log Entries     | N derniers logs                                                   |
| Search Docs          | Interroge l'API documentaire Laravel selon les packages installés |

### Enregistrement manuel du serveur MCP

Selon l'éditeur, un enregistrement manuel peut être nécessaire.

| Champ       | Valeur              |
| ----------- | ------------------- |
| **Command** | `php`               |
| **Args**    | `artisan boost:mcp` |

En JSON :

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

## Guidelines IA

Fichiers d'instructions préchargés au démarrage de l'agent : conventions et patterns fondamentaux de l'écosystème Laravel — pour un code cohérent et de qualité.

### Guidelines disponibles

`core` s'applique quelle que soit la version.

| 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                   |
| Herd              | core                   |
| Inertia Laravel   | core, 1.x, 2.x, 3.x    |
| Inertia React     | core, 1.x, 2.x, 3.x    |
| Inertia Vue       | core, 1.x, 2.x, 3.x    |
| Inertia Svelte    | core, 1.x, 2.x, 3.x    |
| MCP               | core                   |
| Pennant           | core                   |
| Pest              | core, 3.x, 4.x         |
| PHPUnit           | core                   |
| Pint              | core                   |
| Sail              | core                   |
| Tailwind CSS      | core, 3.x, 4.x         |
| Livewire Volt     | core                   |
| Wayfinder         | core                   |
| Enforce Tests     | conditional            |

<Tip>
  Voir [Mise à jour des ressources Boost](#mise-a-jour-des-ressources-boost).
</Tip>

### Ajouter des guidelines personnalisées

Ajoutez des fichiers `.blade.php` ou `.md` dans `.ai/guidelines/*`. Ils sont fusionnés avec ceux de Boost lors de `boost:install`.

### Surcharger une guideline Boost

Créez une guideline au chemin correspondant : Boost utilise la vôtre plutôt que la sienne.

Par exemple, pour surcharger « Inertia React v2 Form Guidance » : `.ai/guidelines/inertia-react/2/forms.blade.php`.

### Guidelines pour packages tiers

Si vous maintenez un package et voulez fournir vos guidelines, ajoutez `resources/boost/guidelines/core.blade.php`. `boost:install` chez les utilisateurs les intégrera.

Rédigez court, orienté action, avec des exemples de code.

```php theme={null}
## Package Name

This package provides [brief description of functionality].

### Features

- Feature 1: [clear & short description].
- Feature 2: [clear & short description]. Example usage:

@verbatim
<code-snippet name="How to use Feature 2" lang="php">
$result = PackageName::featureTwo($param1, $param2);
</code-snippet>
@endverbatim
```

## Agent Skills

Les [Agent Skills](https://agentskills.io/home) sont des modules ciblés, activés à la demande. Ils ne sont pas préchargés — ils apportent des patterns détaillés seulement quand pertinent, ce qui limite le context bloat et améliore la qualité.

Sélectionnez la fonctionnalité Skills lors de `boost:install` : les skills sont installés selon `composer.json`. Ex. : présence de `livewire/livewire` → `livewire-development` installé.

### Skills disponibles

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

<Tip>
  Voir [Mise à jour](#mise-a-jour-des-ressources-boost).
</Tip>

### Créer un skill

Ajoutez `.ai/skills/{skill-name}/SKILL.md`. `boost:update` l'installera aux côtés des skills Boost.

Exemple pour une logique métier :

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

### Surcharger un skill

Créez un skill du même nom : Boost utilise le vôtre.

Par exemple, `.ai/skills/livewire-development/SKILL.md` remplace `livewire-development`.

### Skills de packages tiers

Ajoutez `resources/boost/skills/{skill-name}/SKILL.md` dans votre package. `boost:install` proposera son installation.

Format Agent Skills (frontmatter YAML + Markdown) :

```markdown theme={null}
---
name: package-name-development
description: Build and work with PackageName features, including components and workflows.
---

# Package Name Development

## When to use this skill
Use this skill when working with PackageName features...

## Features

- Feature 1: [clear & short description].
- Feature 2: [clear & short description]. Example usage:

$result = PackageName::featureTwo($param1, $param2);
```

## Guidelines vs Skills

**Guidelines** : préchargées, généralistes, appliquées à tout le code.

**Skills** : à la demande, ciblés (composants Livewire, tests Pest…).

| Aspect         | Guidelines                      | Skills                              |
| -------------- | ------------------------------- | ----------------------------------- |
| **Chargement** | Préchargé, toujours actif       | À la demande                        |
| **Portée**     | Large, fondamentale             | Focalisée, spécifique à une tâche   |
| **But**        | Conventions et bonnes pratiques | Patterns d'implémentation détaillés |

## API documentaire

Boost expose une base de connaissances de 17 000+ documents Laravel avec recherche sémantique (embeddings).

L'outil MCP `Search Docs` interroge cette API selon les packages installés. Les guidelines et skills orientent l'agent à l'utiliser.

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

## Étendre Boost

Boost fonctionne d'emblée avec les principaux IDE / agents. Sinon, créez votre agent et intégrez-le.

### Support d'un nouvel IDE / agent

Créez une classe héritant de `Laravel\Boost\Install\Agents\Agent` et implémentez selon vos besoins :

* `Laravel\Boost\Contracts\SupportsGuidelines`
* `Laravel\Boost\Contracts\SupportsMcp`
* `Laravel\Boost\Contracts\SupportsSkills`

#### Implémentation

```php theme={null}
<?php

declare(strict_types=1);

namespace App;

use Laravel\Boost\Contracts\SupportsGuidelines;
use Laravel\Boost\Contracts\SupportsMcp;
use Laravel\Boost\Contracts\SupportsSkills;
use Laravel\Boost\Install\Agents\Agent;

class CustomAgent extends Agent implements SupportsGuidelines, SupportsMcp, SupportsSkills
{
    // Votre implémentation...
}
```

Voir [ClaudeCode.php](https://github.com/laravel/boost/blob/main/src/Install/Agents/ClaudeCode.php).

#### Enregistrement

Dans `boot()` de `App\Providers\AppServiceProvider` :

```php theme={null}
use Laravel\Boost\Boost;

public function boot(): void
{
    Boost::registerAgent('customagent', CustomAgent::class);
}
```

L'agent apparaîtra dans le choix de `php artisan boost:install`.


## Related topics

- [Laravel et le développement IA](/fr/ai.md)
- [Créer un agent personnalisé pour Boost](/fr/advanced/boost-custom-agent.md)
- [Laravel Boost Custom Agent for GitHub Copilot CLI](/fr/packages/laravel-boost-copilot-cli.md)
- [Laravel Boost Custom Agent for PhpStorm with GitHub Copilot](/fr/packages/laravel-boost-phpstorm-copilot.md)
- [Guide de mise à niveau de Laravel 12 vers 13](/fr/blog/upgrade-12-to-13.md)