PHPackages engaging-io/issue-reporter - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. engaging-io/issue-reporter ActiveLibrary[Utility & Helpers](/categories/utility) engaging-io/issue-reporter ========================== A Laravel package for reporting GitHub issues using AI. v0.0.3(11mo ago)0174↓50%MITPHPPHP ^7.3|^8.0|^8.1|^8.2|^8.3 Since Jun 10Pushed 11mo agoCompare [ Source](https://github.com/james-engaging-io/AI-Issue-Reporter)[ Packagist](https://packagist.org/packages/engaging-io/issue-reporter)[ RSS](/packages/engaging-io-issue-reporter/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (2)Dependencies (2)Versions (5)Used By (0) Laravel AI Issue Reporter ========================= [](#laravel-ai-issue-reporter) [![Latest Version on Packagist](https://camo.githubusercontent.com/49ae3f17a697fe8185d1b814b54f2894ad815da68a51aae83f979b6331f20e8a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f656e676167696e672d696f2f69737375652d7265706f727465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/engaging-io/issue-reporter)[![Total Downloads](https://camo.githubusercontent.com/74f0d3cf688a1a3e72f468f3a9358a1bad8470ebed0125fbf968d6fa76866768/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f656e676167696e672d696f2f69737375652d7265706f727465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/engaging-io/issue-reporter)[![License: MIT](https://camo.githubusercontent.com/458425f8985b0b0c8a736cffe75e05a098e3d77906acddbcad2bfc54492a4e02/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE) A Laravel package for reporting exceptions to a designated endpoint with additional context, which can be used for automatic issue creation with AI assistance. Features -------- [](#features) - Report any exception with comprehensive context data - Special handling for HTTP request exceptions (with additional request data) - Integration with Slack notifications - Connection to your GitHub repository for automated issue tracking - Easy to configure and use in any Laravel application Requirements ------------ [](#requirements) - PHP 7.3+ - Laravel 8.0+ / 9.0+ / 10.0+ / 11.0+ / 12.0+ Installation ------------ [](#installation) You can install the package via Composer: ``` composer require engaging-io/issue-reporter ``` The package will automatically register its service provider if you're using Laravel 5.5+. Configuration ------------- [](#configuration) Publish the configuration file: ``` php artisan vendor:publish --provider="EngagingIo\IssueReporter\IssueReporterServiceProvider" ``` This will create a `config/issue-reporter.php` file where you can modify the package settings. ### Environment Variables [](#environment-variables) Add these variables to your `.env` file: ``` ISSUE_REPORTER_ENABLED=false # Set to true in production environments only ISSUE_REPORTER_GITHUB_REFERENCE=main ISSUE_REPORTER_GITHUB_REPOSITORY=your-repository ISSUE_REPORTER_SLACK_WEBHOOK=https://hooks.slack.com/services/your/slack/webhook ``` > **Note:** Always keep `ISSUE_REPORTER_ENABLED` set to `false` for local development environments to prevent unnecessary reporting of development exceptions. Usage ----- [](#usage) ### Basic Exception Reporting [](#basic-exception-reporting) ``` use EngagingIo\IssueReporter\Facades\IssueReporter; try { // Your code that might throw an exception } catch (\Throwable $e) { IssueReporter::report($e); // Then handle the exception as you normally would } ``` ### In Exception Handlers [](#in-exception-handlers) You can easily use the package in your Laravel exception handler: ``` // app/Exceptions/Handler.php namespace App\Exceptions; use Illuminate\Foundation\Exceptions\Handler as ExceptionHandler; use EngagingIo\IssueReporter\Facades\IssueReporter; use Throwable; class Handler extends ExceptionHandler { // ... public function report(Throwable $exception) { // You can add conditions to determine which exceptions to report if ($this->shouldReportToIssueReporter($exception)) { IssueReporter::report($exception); } parent::report($exception); } private function shouldReportToIssueReporter(Throwable $exception) { // Implement your logic to determine which exceptions to report return !$this->inExcludeList($exception) && app()->environment('production'); } // ... } ``` ### Using bootstrap/app.php (Laravel 10+) [](#using-bootstrapappphp-laravel-10) For Laravel 10 and above, you can also integrate the issue reporter in your `bootstrap/app.php` file: ``` // bootstrap/app.php use Illuminate\Foundation\Application; use Illuminate\Foundation\Configuration\Exceptions; use EngagingIo\IssueReporter\Facades\IssueReporter; // ... return Application::configure(basePath: dirname(__DIR__)) // ... ->withExceptions(function (Exceptions $exceptions) { // This section captures all types of exceptions. $exceptions->reportable(fn (\Throwable $e) => IssueReporter::report($e)); })->create(); ``` ### HTTP RequestException Handling [](#http-requestexception-handling) The package automatically detects if the exception is an HTTP `RequestException` and includes relevant request data in the report: - Request headers - Request body - Response data (if available) This additional information helps with debugging API-related issues. Security -------- [](#security) The package sends exception data to a designated endpoint. Make sure: 1. Your Slack webhook URL is kept secure 2. Your API endpoint is secured with proper authentication 3. Sensitive data in error reports is properly sanitized Configuration Options --------------------- [](#configuration-options) OptionEnvironment VariableDescription`enabled``ISSUE_REPORTER_ENABLED`Whether the issue reporter is enabled (true/false). Should be set to false for local development`reference``ISSUE_REPORTER_GITHUB_REFERENCE`The default branch or reference in your repository (e.g., 'main', 'master')`repository``ISSUE_REPORTER_GITHUB_REPOSITORY`Your repository name in 'repo' format`slack_webhook_url``ISSUE_REPORTER_SLACK_WEBHOOK`Your Slack webhook URL for notificationsContributing ------------ [](#contributing) Contributions are welcome! Please feel free to submit a Pull Request. Credits ------- [](#credits) - [Danniel Libor](https://github.com/dlibor) - [All contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE) for more information. ### Health Score 32 — LowBetter than 71% of packages Maintenance55 Moderate activity, may be stable Popularity13 Limited adoption so far Community6 Small or concentrated contributor base Maturity44 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 3 Last Release 333d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/dad30dead4d121729269eba18be5836e1b28e8a8f908bc29747e871c765d39ae?d=identicon)[danniel.libor](/maintainers/danniel.libor) --- Top Contributors [![danniel-isiah-libor](https://avatars.githubusercontent.com/u/32063464?v=4)](https://github.com/danniel-isiah-libor "danniel-isiah-libor (7 commits)") --- Tags laravelaigithubreporterissueengaging-io ### Embed Badge ![Health badge](/badges/engaging-io-issue-reporter/health.svg) ``` [![Health](https://phpackages.com/badges/engaging-io-issue-reporter/health.svg)](https://phpackages.com/packages/engaging-io-issue-reporter) ``` ### Alternatives [watson/active Laravel helper for recognising the current route, controller and action 3253.6M14](/packages/watson-active)[glhd/conveyor-belt 14797.0k](/packages/glhd-conveyor-belt)[dragon-code/pretty-routes Pretty Routes for Laravel 10058.7k4](/packages/dragon-code-pretty-routes)[erlandmuchasaj/laravel-gzip Gzip your responses. 40129.3k2](/packages/erlandmuchasaj-laravel-gzip)[mischasigtermans/laravel-altitude Claude Code agents for the TALL stack, powered by Laravel Boost 1139.2k](/packages/mischasigtermans-laravel-altitude)[bjuppa/laravel-blog Add blog functionality to your Laravel project 483.3k1](/packages/bjuppa-laravel-blog) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)