> ## 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 accelera lo sviluppo assistito da AI. Fornisce a Cursor, Claude Code e altri agenti server MCP, AI guideline e Agent Skills per capire in profondità la tua app Laravel.

## Introduzione

Laravel Boost accelera lo sviluppo con AI fornendo guideline e Agent Skill agli agenti perché generino codice Laravel di alta qualità e in linea con le best practice.

Boost espone anche una potente API sulla documentazione dell'ecosistema Laravel: knowledge base di oltre 17.000 elementi Laravel-specifici con ricerca semantica basata su embedding. Boost istruisce gli agenti (Claude Code, Cursor, ecc.) a usare quest'API per apprendere le funzionalità e le best practice più recenti.

## Installazione

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

Poi installa server MCP e coding guideline.

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

`boost:install` genera guideline e skill per l'agente scelto.

Dopo l'installazione puoi iniziare a lavorare con Cursor, Claude Code o altri.

<Note>
  I file generati (`.mcp.json`, `CLAUDE.md`, `AGENTS.md`, `junie/`, `boost.json`) possono essere aggiunti al `.gitignore` dell'app: `boost:install` / `boost:update` li rigenerano.
</Note>

### Configurazione degli agenti

<Tabs>
  <Tab title="Cursor">
    1. Apri la command palette (`Cmd+Shift+P` / `Ctrl+Shift+P`)
    2. "/open MCP Settings" e Invio
    3. Attiva il toggle di `laravel-boost`
  </Tab>

  <Tab title="Claude Code">
    Di solito automatico. Se no:

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

  <Tab title="Codex">
    Di solito automatico. Se no:

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

  <Tab title="Gemini CLI">
    Di solito automatico. Se no:

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

  <Tab title="GitHub Copilot (VS Code)">
    1. Command palette (`Cmd+Shift+P` / `Ctrl+Shift+P`)
    2. "MCP: List Servers" e Invio
    3. Seleziona `laravel-boost` e Invio
    4. "Start server"
  </Tab>

  <Tab title="Junie">
    1. Premi `Shift` due volte
    2. Cerca "MCP Settings" e Invio
    3. Seleziona `laravel-boost`
    4. In basso a destra "Apply"
  </Tab>
</Tabs>

### Aggiornare le risorse di Boost

Aggiorna periodicamente guideline e skill locali con `boost:update`.

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

Automatizzalo nello script `post-update-cmd` di Composer:

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

Di default aggiorna solo le risorse già pubblicate. Per pubblicare quelle di pacchetti appena installati:

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

## Server MCP

Espone tool con cui l'agente esamina l'app Laravel, esegue query DB o codice, ecc.

### Tool disponibili

| Tool                 | Descrizione                                                                   |
| -------------------- | ----------------------------------------------------------------------------- |
| Application Info     | Legge versione PHP/Laravel, engine DB, pacchetti versionati, modelli Eloquent |
| Browser Logs         | Legge log ed errori dal browser                                               |
| Database Connections | Elenca le connessioni disponibili                                             |
| Database Query       | Esegue query                                                                  |
| Database Schema      | Legge lo schema                                                               |
| Get Absolute URL     | Converte path relativo in URL assoluto                                        |
| Last Error           | Legge l'ultimo errore dai log                                                 |
| Read Log Entries     | Legge le ultime N righe di log                                                |
| Search Docs          | Interroga l'API della documentazione ospitata Laravel                         |

### Registrazione manuale dell'MCP server

| Voce        | Valore              |
| ----------- | ------------------- |
| **Command** | `php`               |
| **Args**    | `artisan boost:mcp` |

JSON:

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

## AI guideline

Sono file di istruzioni caricati in anticipo che forniscono contesto sull'ecosistema Laravel: convenzioni, best practice, pattern del framework.

### Guideline disponibili

| Pacchetto         | Versioni               |
| ----------------- | ---------------------- |
| 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>
  Aggiorna con [Aggiornare le risorse di Boost](#aggiornare-le-risorse-di-boost).
</Tip>

### Guideline personalizzate

Aggiungi file `.blade.php` o `.md` in `.ai/guidelines/*`. Vengono unite alle guideline di Boost quando esegui `boost:install`.

### Sovrascrittura

Crea guideline personalizzata con lo stesso path per sovrascrivere quelle di Boost.
Esempio: `.ai/guidelines/inertia-react/2/forms.blade.php` per sovrascrivere "Inertia React v2 Form Guidance".

### Guideline in pacchetti di terze parti

Aggiungi `resources/boost/guidelines/core.blade.php` al pacchetto. Con `php artisan boost:install`, Boost la carica automaticamente.

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

Gli [Agent Skills](https://agentskills.io/home) sono moduli di conoscenza on-demand attivati quando l'agente lavora in un dominio specifico. A differenza delle guideline pre-caricate, evitano di gonfiare il contesto.

Con `boost:install` seleziona le skill: vengono installate automaticamente in base ai pacchetti in `composer.json`.

### Skill disponibili

| Skill                      | Pacchetto      |
| -------------------------- | -------------- |
| 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>
  Aggiornale con [Aggiornare le risorse di Boost](#aggiornare-le-risorse-di-boost).
</Tip>

### Skill personalizzate

Crea `SKILL.md` in `.ai/skills/{skill-name}/`. `boost:update` la installerà con le altre.

Esempio:

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

### Sovrascrittura

Con nome corrispondente. Esempio: `.ai/skills/livewire-development/SKILL.md` per sovrascrivere `livewire-development`.

### Skill in pacchetti di terze parti

Aggiungi `resources/boost/skills/{skill-name}/SKILL.md`. Boost la installa quando l'utente esegue `php artisan boost:install`.

Boost supporta il formato Agent Skills con YAML front matter e istruzioni Markdown. Richiesti `name` e `description`.

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

## Guideline vs Skill

Laravel Boost dà due strumenti agli agenti:

**Guideline** — pre-caricate, per convenzioni Laravel di base valide sull'intera codebase.

**Skill** — on-demand, per pattern dettagliati di specifici domini (Livewire, Pest, ecc.).

| Aspetto         | Guideline                     | Skill                              |
| --------------- | ----------------------------- | ---------------------------------- |
| **Caricamento** | Pre-caricate, sempre presenti | On-demand                          |
| **Ambito**      | Ampio, fondativo              | Focalizzato per task               |
| **Scopo**       | Convenzioni e best practice   | Pattern implementativi dettagliati |

## API della documentazione

Boost include un'API con oltre 17.000 elementi Laravel-specifici. Usa ricerca semantica per risultati precisi e contestuali.

Il tool MCP `Search Docs` permette all'agente di interrogare l'API in base ai pacchetti installati. Le guideline e le skill di Boost istruiscono automaticamente l'agente a usarla.

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

## Estendere Boost

Se il tuo strumento non è ancora supportato, crea un agente personalizzato.

### Aggiungere il supporto per un IDE/agente

Estendi `Laravel\Boost\Install\Agents\Agent` e implementa i contract necessari:

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

#### Implementazione

```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
{
    // La tua implementazione...
}
```

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

#### Registrazione

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

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

L'agente comparirà nelle scelte durante `php artisan boost:install`.


## Related topics

- [Laravel e lo sviluppo con AI](/it/ai.md)
- [Creare un agente personalizzato per Boost](/it/advanced/boost-custom-agent.md)
- [Laravel Boost Custom Agent for GitHub Copilot CLI](/it/packages/laravel-boost-copilot-cli.md)
- [Laravel Boost Custom Agent for PhpStorm with GitHub Copilot](/it/packages/laravel-boost-phpstorm-copilot.md)
- [Guida all'aggiornamento da Laravel 12 a 13](/it/blog/upgrade-12-to-13.md)