README

Configure Claude Code for Laravel projects with a single command.

Claudify detects your stack from composer.json and package.json, then sets up permissions, hooks, skills, and plugins — so you don't configure Claude Code manually for every Laravel app.

Requirements

• PHP 8.2+
• Laravel 11, 12, or 13
• Claude Code CLI

Installation

composer require jorgecortesdev/laravel-claudify --dev

Then run the install command:

php artisan claudify:install

What it does

The install command runs these steps in order:

1. Checks for Claude Code CLI

Exits with an error if claude is not in your PATH.

2. Detects your stack

Reads composer.json and package.json to detect:

• Pest, Pint, Boost (from require-dev)
• Node, Prettier, ESLint (from package.json)

3. Offers to install Laravel Boost

If laravel/boost is not installed and your Laravel version supports it (11.45.3+, 12.41.1+, or 13+), you'll be asked whether to install it. Boost provides MCP tools, guidelines, and skills for Claude Code.

4. Installs hooks

Copies auto-format scripts to .claude/hooks/ based on detected formatters:

5. Writes .claude/settings.json

Generates permissions and deny rules based on your stack:

Base permissions (always included):

• Bash(php:*), Bash(php artisan:*), Bash(composer:*)

Conditional permissions (when detected):

Deny rules (always included):

• Edit(.env*), Write(.env*)

Hooks (when formatters detected):

• PostToolUse on Edit/Write: runs Pint on .php files, Prettier on non-PHP files

If .claude/settings.json already exists, new settings are merged without overwriting your existing configuration. Duplicate permissions are deduplicated automatically.

6. Installs skills

Copies Laravel-specific skills to .claude/skills/:

Skills are tracked via a .claudify-manifest.json file so user-created skills in .claude/skills/ are never touched.

7. Installs plugins

Installs Claude Code plugins per-project using the claude CLI:

Plugins already installed at any scope (user, project, or local) are skipped.

Dry run

Preview what would be configured without writing files:

php artisan claudify:install --dry-run

This shows the settings JSON, hook scripts, and skills that would be installed. It does not preview Boost installation or plugin installation since those require network access.

Auto-update on composer update

Add the update command to your composer.json so Claudify refreshes automatically when the package is updated:

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

The update command re-runs guidelines, hooks, settings, and skills non-interactively. It skips Boost installation and plugin installation — those are first-install concerns handled by claudify:install.

Re-running

Safe to re-run claudify:install at any time. Settings are merged (not overwritten), skills are updated, and plugins already installed are skipped. Run it again after adding packages like Pest or Prettier to pick up new permissions and hooks.

Testing

composer test

Formatting

composer format

Acknowledgements

This package was inspired by Laravel Boost and its approach to configuring AI tools for Laravel projects. Some of the bundled skills were informed by community-shared Claude Code skills found across GitHub, rewritten and adapted for consistency and correctness.

License

MIT License. See LICENSE for details.