kayedspace/laravel-doctor

A stateless, live analysis engine for Laravel projects

v1.0.0 2026-07-07 18:42 UTC

Requires

• php: ^8.2 || ^8.3 || ^8.4 || ^8.5
• illuminate/console: ^11.47.0 || ^12.41.1 || ^13.0
• illuminate/support: ^11.47.0 || ^12.41.1 || ^13.0
• laravel/mcp: ^0.7.0 || ^0.8.0
• laravel/prompts: ^0.3.21
• nikic/php-parser: ^5.0

Requires (Dev)

• larastan/larastan: ^3.0
• laravel/pint: ^1.16
• opis/json-schema: ^2.6
• orchestra/testbench: ^9.15 || ^10.8 || ^11.0
• pestphp/pest: ^3.8.5 || ^4.4.1
• pestphp/pest-plugin-laravel: ^3.2 || ^4.1

Apache-2.0

• Ali Youssef Kayed

• php
• laravel
• automation
• analysis
• diagnose

Published on Packagist.org on 2026-07-07 18:47 UTC

README

Laravel Doctor

Laravel Doctor is a command-first diagnostics package for Laravel applications. It exposes one shared analysis engine through Artisan, a browser dashboard, an HTTP API, MCP tools, and a public PHP API.

Note: Public beta is now available.

🌟 Features

• Command-first Diagnostics: Run fast, comprehensive checks directly from your terminal.
• Beautiful Dashboard: A zero-build, Tailwind and Alpine-powered UI to view your reports.
• MCP Integration: First-class tools for AI coding assistants and agent workflows.
• Machine-readable Output: Export scan results as JSON, SARIF, or consume them via HTTP API.
• Shared Engine: A single, robust analysis engine powers the CLI, Dashboard, and APIs simultaneously.
• CI/CD Ready: Built-in support for GitHub Actions and code-scanning workflows.

📖 Full Documentation

The complete, live documentation is available at: https://laravel-doctor.kayed.dev

Please refer to the official documentation for complete usage instructions, configuration options, MCP client setups, GitHub Actions integration, and API references.

✨ Dashboard Preview

Laravel Doctor includes a zero-build browser dashboard to intuitively inspect your application's health.

🚀 Quickstart

1. Installation

composer require kayedspace/laravel-doctor

2. Run Diagnostics

php artisan doctor:scan

3. Open the Dashboard

Visit /_doctor in your local environment. (If you need to customize the route or access gates, publish the configuration file).

🧩 Architecture

flowchart LR
    A[Artisan CLI] --> R[DoctorRequest]
    B[Dashboard] --> R
    C[HTTP API] --> R
    D[MCP Tools] --> R
    E[PHP API] --> R
    R --> S[Shared Scan Engine]
    S --> F[Findings and Report]

Loading

🔐 Security Notes

• Static rules do not boot Laravel.
• Booted runtime rules are designed to remain read-only.
• Reports redact known secret-looking values before serialization.
• Do not expose the dashboard or HTTP API in shared environments without authentication.

🤝 Development & Contributing

See CONTRIBUTING.md for package development and documentation workflow expectations.