About this tool
Laravel Tackle is an AI agent harness for Laravel: coding agents that read your codebase, run your tests, review your PRs, upgrade dependencies, and heal failed jobs — installed via Composer.
Key Capabilities
- Coding agents: Classes implementing
CodingAgentreceive a prompt, call tools, and return a result. - Command suite:
ai:code,ai:upgrade,ai:eval,ai:explain,ai:fix,ai:onboard,ai:respond,ai:review,ai:run,ai:test. - Dependency upgrades:
ai:upgradeaudits, plans, resolves, fixes, and verifies safe major version upgrades for Composer dependencies in an isolated worktree, delivered as a PR. - Code review:
ai:reviewis a read-only agent that reviews git diffs and surfaces real issues with severity levels. - Test generation:
ai:testgenerates a Pest test file for any class or method. - Issue fixing:
ai:fixaccepts a pasted exception, a Sentry issue (--sentry=ID), or a GitHub issue (--issue=N); the agent diagnoses, patches, and verifies the fix. - CI and cron:
ai:runruns the same agent with no terminal attached: one task, a JSON result, and an exit code. - PR interaction:
ai:respondacts on a/tacklecomment left on a pull request: applies the requested change, pushes it to the PR branch, and replies in the thread. - Developer onboarding:
ai:onboardprovides a guided, read-only tour of the codebase and answers questions. - Benchmarking:
ai:evalbenchmarks the agent against seeded bugs — fix rate, false-fix rate, tokens, cost.
Architecture and Safety
- Built on top of
laravel/aiand provider-agnostic like it: Tackle runs on any providerlaravel/aisupports with tool calling. - Every agent runs through the same tool infrastructure and safety layer.
NetworkExfiltrationGuardflags the exfiltration transport: outbound HTTP in agent-authored code,curl ... | sh, external curl/wget. Mode block (default), confirm, or off.
Usage and Configuration
- Installed via Composer.
- Publish the config:
php artisan vendor:publish --provider="Laravel\Ai\AiServiceProvider". - Run
php artisan ai:codeand type a small test task to confirm everything connects. - Major upgrades are long sessions — consider raising
AI_CODE_BUDGETbeyond the default $1 before starting one. - Requires
laravel/ai >=0.1 <0.11;laravel/ai 0.1.xitself requires PHP ^8.4; on PHP 8.3 Composer will resolve 0.2 or newer.
Open Source and Commercialization
- Open-source, free.
- Learning curve: medium.
Features & use cases
[ ] Publish the laravel/ai config: php artisan vendor:publish --provider="Laravel\Ai\AiServiceProvider"[ ] Run php artisan ai:code and type a small test task to confirm everything connects.4' } - run: composer install --no-interaction --no-scripts - run: | php artisan ai:upgrade pestphp/pest \ --headless --output=json --no-worktree \ --ref-issue=${{ githuba human stays the trigger — read it and run php artisan ai:upgrade <package> to turn it into a PR, or wire up the unattended mode belowAgentsClasses implementing CodingAgent that receive a prompt, call tools, and return a resultai:evalBenchmarks the agent against seeded bugs — fix rate, false-fix rate, tokens, costai:explainExplains what a file, class, or method does in plain Englishai:fixA focused fix session: paste an exception, point it at a Sentry issue (--sentry=ID) or GitHub issue (--issue=N), and the agent diagnoses, patches, and verifies the fixai:onboardOnboards a new developer: a guided, read-only tour of the codebase — what it is, how it's put together, how to run it, where to be careful — then answers their questionsai:respondActs on a /tackle comment left on a pull request: applies the requested change, pushes it to the PR branch, and replies in the threadai:reviewA read-only agent that reviews git diffs and surfaces real issues with severity levelsai:runThe same agent with no terminal attached: one task, a JSON result, and an exit code — for CI and cron