Download the PHP package arielmejiadev/healing-factor without Composer

On this page you can find all versions of the php package arielmejiadev/healing-factor. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of arielmejiadev/healing-factor

Informations about the package healing-factor

Healing-Factor

Latest Version on Packagist GitHub Tests Action Status Total Downloads

A self-healing Laravel package that catches exceptions and automatically creates pull requests with fixes using AI. When an error occurs in your app, Healing-Factor captures it, spins up an AI agent in an isolated git worktree, and opens a draft PR with the fix — all without touching your production code.

To learn all about it, head over to the extensive documentation.

How It Works

  1. An exception occurs in your Laravel app
  2. Healing-Factor captures it via a webhook (Nightwatch/Bugsnag) or the built-in exception listener
  3. The exception is fingerprinted, debounced, and deduplicated
  4. A queued job creates an isolated git worktree on a new branch
  5. An AI agent (Claude Code, OpenCode, or the Anthropic API) analyzes the code and writes a fix
  6. The fix is committed, pushed, and a draft pull request is opened
  7. The worktree is automatically cleaned up
  8. You review the PR and merge

Requirements

Plus one of:

Driver Requires
cli Claude Code or OpenCode installed on the server
api Only an ANTHROPIC_API_KEY (no CLI installation needed)

Installation

This publishes the config, runs the migration, and verifies your setup.

Quick Start

Pick the setup that matches your environment:

Option A: CLI Driver + Exception Listener (simplest)

No external monitor needed. Healing-Factor listens to Laravel errors directly.

Option B: CLI Driver + Nightwatch Webhook

Option C: API Driver (no CLI installation needed)

Ideal for staging/production servers (DigitalOcean, Laravel Cloud, AWS) where you can't install CLI tools.

Then start a queue worker:

Why APP_ENV=staging? Healing-Factor only runs in production and staging by default. In local, errors are expected during development. You can change this in config/healing-factor.php under environments.

Why no ANTHROPIC_API_KEY for CLI? Claude Code handles its own authentication. The API driver calls the Anthropic API directly, so it needs the key.

Verify Your Setup

This creates a test issue and dispatches it for resolution. Add --sync to skip the queue.

Dashboard

Healing-Factor includes a web dashboard at /healing-factor to browse issues, view stacktraces, see PR links, and retry failed resolutions.

By default it's only accessible in local. To allow access in other environments, register an auth gate in your AppServiceProvider:

Artisan Commands

Command Description
healing-factor:install Publish config, run migration, verify setup
healing-factor:test Create a test issue to verify the pipeline
healing-factor:status Show all issues with summary statistics
healing-factor:retry {id} Retry a failed issue
healing-factor:prune Delete old resolved/failed issues
healing-factor:recover-stale Mark stuck resolving issues as failed

Recommended Schedule

Configuration Highlights

All config lives in config/healing-factor.php. Key options:

Option Env Variable Default Description
Master switch HEALING_FACTOR_ENABLED true Disable all processing
Dry run HEALING_FACTOR_DRY_RUN false Log actions without executing
Driver HEALING_FACTOR_DRIVER cli cli or api
CLI tool HEALING_FACTOR_CLI_TOOL claude claude or opencode
Monitor HEALING_FACTOR_MONITOR nightwatch nightwatch, bugsnag, or exception_listener
Timeout HEALING_FACTOR_PROCESS_TIMEOUT 3600 Max seconds for CLI process
Debounce HEALING_FACTOR_DEBOUNCE_MINUTES 5 Min minutes between same exception

Exception Categories

Customize AI behavior per exception type — each category can override cli_tool, model, timeout, max_turns, and prompt:

Ignored Exceptions

Exceptions that should never be processed (infrastructure issues, unfixable errors):

Events

Event Fired When
IssueCreated Issue created from webhook or exception
IssueResolving Resolution starts
IssueResolved Resolution succeeds
IssueResolutionFailed Resolution fails

What Healing-Factor Can Fix

Any runtime exception that occurs while the app is still running:

What It Cannot Fix

Documentation

See docs/documentation.md for the full reference including webhook setup, signature verification, API driver details, custom prompts, security model, theming, and troubleshooting.

Testing

Changelog

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

Credits

License

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

All versions of healing-factor with dependencies

PHP Build Version
Package Version
Requires php Version ^8.4
anthropic-ai/sdk Version ^0.8
illuminate/contracts Version ^11.0||^12.0||^13.0
spatie/laravel-package-tools Version ^1.16
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package arielmejiadev/healing-factor contains the following files

Loading the files please wait ...