Looking to hire Laravel developers? Try LaraJobs

laravel-ai-harness maintained by mrkoopie

Description
A Laravel package that installs and refreshes AI agent harnessing, local runtime drivers, and quality foundations.
Last update
2026/06/29 17:47 (dev-codex/fix-boost-marker-collision)
License
MIT
Links
Homepage - GitHub - Packagist
Downloads
0
Tags
laravel - harness - agents - ai - codex - claude

dev-codex/fix-boost-marker-collision

Last update
2026/06/29 17:47
License
MIT
Require
  • php ^8.2
  • illuminate/console ^11.0|^12.0|^13.0
  • illuminate/contracts ^11.0|^12.0|^13.0
  • illuminate/support ^11.0|^12.0|^13.0
  • spatie/laravel-package-tools ^1.92
Comments
comments powered by Disqus

Laravel AI Harness

Laravel AI Harness installs and refreshes the files that make AI agents useful in a Laravel project: agent instructions, MCP configuration, local runtime helpers, worktree setup hooks, and repeatable quality guidance.

The package is intentionally conservative. Human-editable files receive managed blocks, generated scripts/config files are package-owned, and optional tooling such as Docker and Polyscope is opt-in.

Installation

composer require mrkoopie/laravel-ai-harness
php artisan ai-harness:install

The install command writes the initial harness files and adds this command to both Composer lifecycle hooks:

@php artisan ai-harness:update --ansi

After that first install, Composer will refresh managed harness files on every composer install and composer update.

When ai-harness:install is run with --with=* feature flags, those flags are preserved in the Composer hook.

Commands

php artisan ai-harness:install
php artisan ai-harness:update
php artisan ai-harness:doctor

ai-harness:install writes the harness and patches Composer scripts.

ai-harness:update refreshes package-managed files and blocks.

ai-harness:doctor checks whether the selected harness surface exists.

All commands accept --path=/path/to/project for testing or non-standard project roots.

Optional Features

Codex, Claude, shared MCP configuration, and the generated harness skill are enabled by default.

Docker and Polyscope are opt-in:

php artisan ai-harness:install --with=docker --with=polyscope
php artisan ai-harness:update --with=docker --with=polyscope

Feature defaults can also be configured:

AI_HARNESS_CODEX=true
AI_HARNESS_CLAUDE=true
AI_HARNESS_SKILLS=true
AI_HARNESS_HERD=false
AI_HARNESS_DOCKER=false
AI_HARNESS_POLYSCOPE=false

Laravel Boost

This package ships Laravel Boost resources for package discovery:

  • resources/boost/guidelines/core.blade.php
  • resources/boost/skills/laravel-ai-harness/SKILL.md

After installing Laravel Boost, run php artisan boost:install or php artisan boost:update --discover and select mrkoopie/laravel-ai-harness when Boost asks for third-party guidelines or skills.

Boost and AI Harness own different generated regions. Boost refreshes its <laravel-boost-guidelines> block, while AI Harness refreshes its own <!-- ai-harness:start --> blocks and generated harness files.

Generated Files

Default files:

  • AGENTS.md
  • CLAUDE.md
  • .ai/mcp/mcp.json
  • .dev/bin/ai-harness
  • .codex/config.toml.example
  • .codex/environments/environment.toml
  • .codex/hooks.json
  • .codex/scripts/local-environment.sh
  • .claude/settings.json
  • .agents/skills/laravel-ai-harness/SKILL.md
  • .claude/skills/laravel-ai-harness/SKILL.md

Optional files:

  • docker/mysql/init/10-create-testing-database.sh
  • polyscope.json

Development

composer install
composer test
composer analyse
vendor/bin/pint --test --format agent
composer validate --strict

PHPStan uses Larastan. Run it through composer analyse, which passes --memory-limit=1G for Laravel package analysis.

Documentation