README

Adds support for Amazon's Kiro IDE in Laravel Boost, integrating the MCP (Model Context Protocol) server and AI guidelines specifically designed for Kiro.

About Kiro IDE

Kiro IDE is an AI-powered integrated development environment from Amazon that supports the Model Context Protocol (MCP), allowing AI agents to interact with your Laravel project in a contextualized and efficient manner.

About Laravel Boost

Laravel Boost accelerates AI-assisted development by providing the essential context and structure that AI needs to generate high-quality, framework-specific Laravel code. This package extends Boost to work seamlessly with Kiro IDE.

Requirements

PHP 8.2 or higher
Laravel 11.x or 12.x
Laravel Boost ^2.0
Kiro IDE installed on your system

Installation

You can install the package via Composer:

composer require jcf/boost-for-kiro-ide --dev

The package automatically registers Kiro IDE with Laravel Boost through Laravel's auto-discovery.

✨ Laravel Boost v2.0 Improvements
This package is fully compatible with Laravel Boost v2.0, which brings an enhanced installation experience with improved code environment detection, streamlined configuration, and the powerful new Skills system. After installation, you'll have access to the boost:add-skill command to extend Kiro's capabilities with specialized AI instructions.

Usage

1. Install Laravel Boost (if not already installed)

If you don't have Laravel Boost installed yet, install it first:

composer require laravel/boost --dev
php artisan boost:install

2. Configure Kiro IDE

When running the php artisan boost:install command, Kiro IDE will appear as an available option. Select it to automatically configure:

MCP Configuration: Created at .kiro/settings/mcp.json
AI Guidelines: Created at .kiro/steering/laravel-boost.md

3. Activate in Kiro IDE

In Kiro IDE:

Open the command palette (Cmd+Shift+P or Ctrl+Shift+P)
Search for "MCP: Reconnect All Servers" and press Enter
The laravel-boost MCP server will be automatically detected and connected

Kiro automatically loads the AI guidelines from .kiro/steering/laravel-boost.md to provide contextualized assistance for your Laravel application.

4. Extend with Skills (Optional)

After installation, you can enhance Kiro's capabilities by installing Skills:

php artisan boost:add-skill laravel/boost-skill-livewire

Skills provide specialized AI instructions for specific Laravel development tasks. See the Skills System Support section below for more details.

Complete Installation Flow Example

Here's a complete example of setting up a new Laravel project with Kiro IDE and Skills:

# 1. Create a new Laravel project
composer create-project laravel/laravel my-project
cd my-project

# 2. Install Laravel Boost and this package
composer require laravel/boost --dev
composer require jcf/boost-for-kiro-ide --dev

# 3. Run the Boost installation wizard
php artisan boost:install
# → Select "Kiro IDE" from the list
# → Configuration files are created automatically

# 4. (Optional) Install Skills to extend capabilities
php artisan boost:add-skill laravel/boost-skill-livewire
php artisan boost:add-skill laravel/boost-skill-testing

# 5. Open in Kiro IDE and reconnect MCP servers
# → Cmd+Shift+P (or Ctrl+Shift+P)
# → "MCP: Reconnect All Servers"
# → Start developing with AI assistance!

Created File Structure

After installation, the following files will be created in your Laravel project:

.kiro/
├── settings/
│   └── mcp.json           # MCP server configuration
└── steering/
    └── laravel-boost.md   # AI guidelines for Kiro

You can add these files to .gitignore if desired, as they can be regenerated by running php artisan boost:install or php artisan boost:update.

Available MCP Tools

After installation, Kiro will have access to all Laravel Boost MCP tools, including:

Application Info: Information about PHP, Laravel, packages, and Eloquent models
Browser Logs: Browser logs and errors
Database Connections: Database connection inspection
Database Query: Execute database queries
Database Schema: Read database schema
Get Config: Get configuration values
Last Error: Read the last error from logs
List Artisan Commands: List available Artisan commands
List Routes: List application routes
Read Log Entries: Read log entries
Search Docs: Search Laravel documentation
Tinker: Execute arbitrary code in the application context
And much more...

Updating Guidelines

To keep your AI guidelines up to date with the latest versions of installed Laravel ecosystem packages, run:

php artisan boost:update

You can also automate this process by adding it to your Composer scripts:

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

Skills System Support

Laravel Boost v2.0 introduces a powerful Skills system that extends AI-assisted development with specialized, reusable instructions. The boost-for-kiro-ide package provides zero-configuration support for Skills - they work automatically with Kiro IDE.

What are Skills?

Skills are modular AI instructions (markdown files) that enhance Kiro's ability to perform specific Laravel development tasks. They provide specialized knowledge, workflow automation, and best practices for common patterns.

Installing Skills

Install skills from GitHub repositories using the boost:add-skill command:

php artisan boost:add-skill owner/repository

Example:

php artisan boost:add-skill laravel/boost-skill-livewire

Skills are automatically:

Downloaded and installed to .ai/skills/
Loaded by Laravel Boost
Made available to Kiro IDE through the MCP protocol
No additional configuration required!

How It Works

Automatic Loading: Laravel Boost loads skills from .ai/skills/
MCP Integration: Skills are delivered to Kiro through the Model Context Protocol
Zero Configuration: No Kiro-specific setup needed - it just works!
Immediate Availability: Skills are available in Kiro's AI context right away

Creating Custom Skills

You can create custom skills for your team:

mkdir -p .ai/skills/my-custom-skill
touch .ai/skills/my-custom-skill/SKILL.md

Write your skill instructions in the SKILL.md file, and it's automatically available to Kiro.

For more information about the Skills system, see the Laravel Boost documentation.

Compatibility

This package is designed to be compatible with all versions of Laravel Boost ^2.0. It uses the extension hooks provided by Laravel Boost to register the Kiro code environment.

Tested Versions

Laravel Boost: ^2.0
Laravel: 11.x, 12.x
PHP: 8.2, 8.3, 8.4

Automatic Detection

The package automatically detects Kiro IDE installations in the following locations:

macOS:

/Applications/Kiro.app

Linux:

/opt/kiro
/usr/local/bin/kiro
~/.local/bin/kiro

Windows:

%ProgramFiles%\Kiro
%LOCALAPPDATA%\Programs\Kiro

Project Detection:

Presence of the .kiro directory in the project

Testing

Run the tests with:

composer test

To run only static analysis:

composer lint

Changelog

Please see CHANGELOG for more information about what has changed recently.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Security

If you discover any security related issues, please email jotacfurtado@gmail.com instead of using the issue tracker.

Credits

João C. Furtado
Laravel Boost - Original package that this extends
All Contributors

License

The MIT License (MIT). Please see License File for more information.

jcf / boost-for-kiro-ide

Maintainers

Details