README

Introduction

Laravel Extra Boost is a fork of the original gonetone/laravel-boost-windsurf-extension package. It's an extension package for Laravel Boost that provides integration for additional AI-powered development environments including Windsurf and Antigravity. This package enhances Laravel Boost by adding support for these modern AI coding assistants and provides custom commands to manage frontmatter in guideline files.

About This Implementation

This package follows my personal workflow methodology. Instead of using the .windsurfrules file, it uses the .windsurf/rules/laravel-boost.md directory structure. Similarly, rather than having separate options for Windsurf and Windsurf JetBrains plugins, when creating the Windsurf MCP configuration, it creates it in both .codeium and .codeium/windsurf directories to ensure compatibility with both setups.

Features

Windsurf Integration: Full support for Windsurf editor and Windsurf JetBrains plugin
Antigravity Integration: Complete support for Antigravity AI development environment
Custom Frontmatter Management: Automatically fixes frontmatter in guideline files for supported environments
MCP Server Configuration: Configures Model Context Protocol (MCP) servers for supported environments
Enhanced Commands: Provides extra-boost:install and extra-boost:update commands

Requirements

PHP 8.1 or higher
Laravel 10.49.0, 11.45.3, or 12.41.1 and higher
Windsurf Editor or Windsurf JetBrains Plugin (for Windsurf support)
Antigravity (for Antigravity support)

Installation

Step 1: Install the Package

Install the package via Composer as a development dependency:

composer require akrista/laravel-extra-boost --dev

Step 2: Install Laravel Boost

Run the enhanced install command to install Laravel Boost with support for Windsurf and Antigravity:

php artisan extra-boost:install

This command will:

Install Laravel Boost with all its features
Automatically detect and configure supported environments
Fix frontmatter in guideline files for Windsurf and Antigravity

During installation, you will be prompted to select environments. The available options will include:

windsurf - For Windsurf Editor and Windsurf JetBrains Plugin
antigravity - For Antigravity AI development environment

Optional Installation Parameters

You can skip specific features during installation:

# Skip installing AI guidelines
php artisan extra-boost:install --ignore-guidelines

# Skip installing MCP server configuration
php artisan extra-boost:install --ignore-mcp

# Skip both
php artisan extra-boost:install --ignore-guidelines --ignore-mcp

Usage

Updating Guidelines

To update Laravel Boost guidelines and fix frontmatter for supported environments:

php artisan extra-boost:update

Switching Between Projects

Since Windsurf and Antigravity use global-level MCP configuration files, you need to run the following command when switching between different Laravel projects:

php artisan extra-boost:install --no-interaction

This ensures that the MCP configuration points to the correct path for the current project.

Configuration

After installation, the package will automatically:

Register the Windsurf and Antigravity environments with Laravel Boost
Configure MCP servers for supported environments
Create or update guideline files with proper frontmatter:
- .windsurf/rules/laravel-boost.md for Windsurf
- .agent/rules/laravel-boost.md for Antigravity

License

Laravel Extra Boost is open-sourced software licensed under the MIT license.

akrista / laravel-extra-boost

Maintainers

Details