PHPackages                             clcbws/laravel-agents-debug - 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. [Debugging &amp; Profiling](/categories/debugging)
4. /
5. clcbws/laravel-agents-debug

ActiveLibrary[Debugging &amp; Profiling](/categories/debugging)

clcbws/laravel-agents-debug
===========================

A Zero-JS, High-Fidelity Server-Side Diagnostics &amp; Profiling Suite for Laravel 12/13.

3.1.1(2mo ago)531↓55.6%MITPHPPHP ^8.3|^8.4CI passing

Since May 22Pushed 2mo agoCompare

[ Source](https://github.com/ahtesham-clcbws/laravel-agents-debug)[ Packagist](https://packagist.org/packages/clcbws/laravel-agents-debug)[ Docs](https://github.com/ahtesham-clcbws/laravel-agents-debug)[ RSS](/packages/clcbws-laravel-agents-debug/feed)WikiDiscussions main Synced 1w ago

READMEChangelogDependencies (7)Versions (6)Used By (0)

[![Laravel Agent-Debugger](https://camo.githubusercontent.com/5ef8b1ea837961d1b58f0dd54efd5ebcecf8d663ca71930788d952548a36b514/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2532304167656e742d2d44656275676765722d76332e312e312d4646324432303f7374796c653d666f722d7468652d6261646765266c6f676f3d6c61726176656c266c6f676f436f6c6f723d7768697465)](https://camo.githubusercontent.com/5ef8b1ea837961d1b58f0dd54efd5ebcecf8d663ca71930788d952548a36b514/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2532304167656e742d2d44656275676765722d76332e312e312d4646324432303f7374796c653d666f722d7468652d6261646765266c6f676f3d6c61726176656c266c6f676f436f6c6f723d7768697465)**A zero-JS, high-fidelity server-side diagnostics &amp; profiling suite for Laravel 12.x / 13.x**

[![Packagist Version](https://camo.githubusercontent.com/50c0877832d22990db9a0cae2220011c74e5d5df3fb98127cbbfc701aa9ff72f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f636c636277732f6c61726176656c2d6167656e74732d64656275673f636f6c6f723d464632443230266c6162656c3d5061636b6167697374266c6f676f3d7061636b6167697374266c6f676f436f6c6f723d7768697465)](https://packagist.org/packages/clcbws/laravel-agents-debug)[![PHP](https://camo.githubusercontent.com/ccaa43fc634d348cffccb1d8db7b55d9f17c5d46944bc99a15c3c982724b387d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322532422d3737374242343f6c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://www.php.net)[![Laravel](https://camo.githubusercontent.com/535fcd15a716ae03e5808304836fafedac0bad5c2cfd2275d06ff6202e892b14/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31322e7825324631332e782d4646324432303f6c6f676f3d6c61726176656c266c6f676f436f6c6f723d7768697465)](https://laravel.com)[![License](https://camo.githubusercontent.com/6c290d3fa30f4a51454757590f2beec29a83cccdfcd9945e2c0d387af01477f3/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d4d49542d323263353565)](LICENSE)[![Tests](https://camo.githubusercontent.com/1e8846455f78214072cec3d2aec76423a7f30981297142b441be29dfc2741d18/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f54657374732d3130253246313025323050617373696e672d323263353565)](tests/)

---

What Is It?
-----------

[](#what-is-it)

**Laravel Agent-Debugger** is a premium require-dev diagnostic middleware suite that runs 100% server-side. It produces richly structured, compact log files designed to be read by both human developers and AI coding agents — with zero frontend JavaScript overhead, zero Composer runtime dependencies, and zero production leakage.

---

Quick Start
-----------

[](#quick-start)

```
composer require --dev clcbws/laravel-agents-debug
php artisan vendor:publish --provider="LaravelAgentDebugger\DebugActivityServiceProvider"
php artisan agent:debug-on
```

Then visit your visual dashboard:

```
http://localhost/_agent_debug/dashboard

```

[![Laravel Agent-Debugger Dashboard](dashboard.jpeg)](dashboard.jpeg)

---

✨ Feature Overview (v3.1.1 — 13 Dashboard Tabs &amp; 29 Server-Side Profilers)
------------------------------------------------------------------------------

[](#-feature-overview-v311--13-dashboard-tabs--29-server-side-profilers)

### 🔍 Core Diagnostics

[](#-core-diagnostics)

\#FeatureDescription1🔴 Floating Viewport BadgeGlassmorphic real-time badge showing duration, memory &amp; query count2🧭 Session Breadcrumb TrailLast-10-request navigation map with status codes3🪝 Caught Exception TrackerSurfaces silently swallowed `try-catch` redirects4💳 DB Transaction AuditorInline `beginTransaction`, `commit`, `rollBack` sequence logger5⚠️ N+1 Query Loop DetectorFlags queries running 5+ times with eager-load remedies6🔄 Config &amp; Env Drift DetectorSHA-256 diff between requests for `.env` key changes7🖌️ Blade Compiler ResolverMaps compiled view paths back to physical `.blade.php` lines8🛡️ Gate &amp; Policy ProfilerLogs all authorization ability evaluations and outcomes9💾 Session State LoggerExposes developer-defined session variables per request10👤 Actor Enrichment CardMaps authenticated User ID to email/username profile### 🗃️ Database &amp; Query Intelligence

[](#️-database--query-intelligence)

\#FeatureDescription11🔬 Visual SQL EXPLAIN AnalyzerRuns `EXPLAIN` on any query and visualizes index scan plans12👥 Duplicate &amp; Redundant Query DetectorFlags exact duplicate queries with caching advice13📝 Interactive SQL PlaygroundSafe read-only live `SELECT` terminal inside the dashboard14💾 SQL Database Index AdvisorHeuristic `WHERE`/`JOIN` column analysis with migration code### 📢 Async &amp; Side-Effect Telemetry

[](#-async--side-effect-telemetry)

\#FeatureDescription15🎧 Queue Job &amp; Event Payload SerializerCaptures dispatched event/job payloads16📧 Outgoing Mail SandboxIntercepts Mailables and renders HTML previews in-dashboard17🗂️ Cache Hit/Miss MonitorTracks `get`/`put`/`forget` with keys, TTLs, and byte sizes18🔄 Eloquent Model Lifecycle TrackerLogs `creating`, `created`, `updating`, `deleting` observers### ⏱️ Visual Profiling &amp; Timelines

[](#️-visual-profiling--timelines)

\#FeatureDescription19⏱️ DevTools-Style Timeline WaterfallProportional Gantt chart of Boot → DB → Spans → HTTP20🗺️ Blade Template Composition TreeVisual nesting sequence flowchart for view hierarchies21📊 Live PHP Memory Flame-GraphReal `memory_get_peak_usage()` layered allocation breakdown22📊 Outgoing Latency RadarDB vs app overhead performance ratio meters### 🛠️ Environment, Security &amp; DevOps

[](#️-environment-security--devops)

\#FeatureDescription23🔌 Livewire Hydration State TrackerDiscrete state dumps for Livewire component updates24🚨 Dev Environment Config ShieldTCP socket checks for Redis and SMTP on `artisan serve`25🍪 Cookie &amp; CSRF Token DebuggerDemystifies silent 419 Page Expired errors26⚖️ .env vs .env.example Diff AuditSide-by-side grid of missing or drifted config keys27🏷️ Category Tag Filtering (`?_debug_tag=x`)URL-appended tags for scoped log filtering28🩹 Composer Security AuditorCVE advisory scan of `composer.lock` packages29🚀 Git Branch Correlation AnalyzerActive branch badge and uncommitted file diff warnings### 🖥️ Dashboard &amp; Streaming

[](#️-dashboard--streaming)

\#FeatureDescription30🚿 Real-time SSE Log StreamingPersistent `EventSource` stream with AJAX fallback31🎭 Outgoing API Mock InterceptorUI rule builder for `Http::fake()` JSON stubs32🧪 Browser-Based PHPUnit RunnerOne-click in-dashboard test suite executor33🛠️ Artisan Quick-ConsoleCache, route, and debug-clean from the dashboard header---

Artisan CLI Commands
--------------------

[](#artisan-cli-commands)

```
php artisan agent:debug-on          # Enable profiling
php artisan agent:debug-off         # Disable profiling
php artisan agent:debug-status      # Show current config & storage footprint
php artisan agent:debug-clean       # Purge log files (--days=X optional)
php artisan agent:debug-tail        # Live CLI log stream
php artisan agent:debug-record      # Export session as portable .md/.json bundle
```

---

Dashboard Routes
----------------

[](#dashboard-routes)

RouteMethodDescription`/_agent_debug/dashboard`GETVisual SPA profiling dashboard`/_agent_debug/logs`GETRaw JSON log data`/_agent_debug/sse`GETServer-Sent Events live stream`/_agent_debug/explain`POSTRun `EXPLAIN` on a SQL query`/_agent_debug/playground`POSTExecute a safe `SELECT` query`/_agent_debug/run-tests`POSTExecute PHPUnit feature tests`/_agent_debug/mocks`GETList active HTTP mock rules`/_agent_debug/mock-save`POSTSave HTTP mock interceptor rules`/_agent_debug/artisan/{cmd}`POSTRun Artisan quick-console commands---

Documentation
-------------

[](#documentation)

- **Vision** –
- **Core Features** –
- **Configuration** –
- **Artisan CLI Guide** –
- **Log Schema** –
- **Changelog v3.1.1** –
- **Changelog v3.1.0** –
- **Changelog v2.9.0** –

---

Origin Story
------------

[](#origin-story)

> *"I developed this package because in some projects I had to spend a lot of time just explaining the problem to my AI coding agents. I started with a lightweight middleware helper and kept adding features. Soon I realized other developers faced the same bottleneck, so I decided to share it with the community. This is an invention of need."* — **Ahtesham**

---

[![Packagist](https://camo.githubusercontent.com/c9afa67d24d9fe718ffd5f8bc97f3dcbf1fcbb01b2ecb6cca153032339252772/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f566965772532306f6e2532305061636b61676973742d4646324432303f7374796c653d666f722d7468652d6261646765266c6f676f3d7061636b6167697374266c6f676f436f6c6f723d7768697465)](https://packagist.org/packages/clcbws/laravel-agents-debug)

###  Health Score

43

—

FairBetter than 89% of packages

Maintenance87

Actively maintained with recent releases

Popularity14

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity55

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

5

Last Release

63d ago

Major Versions

2.9.0 → 3.1.02026-05-22

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/17913874?v=4)[Ahtesham Abdul Aziz](/maintainers/ahtesham-clcbws)[@ahtesham-clcbws](https://github.com/ahtesham-clcbws)

---

Top Contributors

[![ahtesham-clcbws](https://avatars.githubusercontent.com/u/17913874?v=4)](https://github.com/ahtesham-clcbws "ahtesham-clcbws (27 commits)")

### Embed Badge

![Health badge](/badges/clcbws-laravel-agents-debug/health.svg)

```
[![Health](https://phpackages.com/badges/clcbws-laravel-agents-debug/health.svg)](https://phpackages.com/packages/clcbws-laravel-agents-debug)
```

###  Alternatives

[laravel/cashier

Laravel Cashier provides an expressive, fluent interface to Stripe's subscription billing services.

2.5k30.2M151](/packages/laravel-cashier)[psalm/plugin-laravel

Psalm plugin for Laravel

3345.3M347](/packages/psalm-plugin-laravel)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9762.4M133](/packages/roots-acorn)[mike-bronner/laravel-model-caching

Automatic caching for Eloquent models.

2.4k96.5k1](/packages/mike-bronner-laravel-model-caching)[api-platform/laravel

API Platform support for Laravel

58174.6k17](/packages/api-platform-laravel)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

255.2k](/packages/aedart-athenaeum)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
