PHPackages                             newdebugbar/newdebugbar - 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. newdebugbar/newdebugbar

ActiveLibrary

newdebugbar/newdebugbar
=======================

A modern Laravel debug bar built with Livewire.

1219↑2900%1PHPCI passing

Since Aug 9Pushed today1 watchersCompare

[ Source](https://github.com/newdebugbar/newdebugbar)[ Packagist](https://packagist.org/packages/newdebugbar/newdebugbar)[ RSS](/packages/newdebugbar-newdebugbar/feed)WikiDiscussions main Synced today

READMEChangelogDependenciesVersions (1)Used By (0)

New Debug Bar (for Laravel)
===========================

[](#new-debug-bar-for-laravel)

New Debug Bar is a modern debugging tool for Laravel, built for developers and coding agents. It helps you understand each request and find problems without cluttering your local app.

A compact bar at the bottom of the page gives you quick access to database queries, errors, logs, events, jobs, mail, cache use, and more.

It works with Blade, Livewire, and Inertia.

Use with coding agents
----------------------

[](#use-with-coding-agents)

New Debug Bar saves a clear profile for each request. A coding agent can use it to understand what happened, spot errors or slow work, explain the likely cause, and point you to what to inspect next. Common secrets are hidden, and the agent can only read the saved profiles.

Instead of giving the agent large logs, browser dumps, or a broad codebase and asking it to guess, it can request the small, relevant, structured summary or finding from a saved profile. In our nine-profile test, MCP used 68% fewer tokens than full profile dumps.

### Codex plugin

[](#codex-plugin)

The optional Codex plugin is the simplest path for Codex users. It gives Codex a New Debug Bar skill and access to profiles from the Laravel app you have open, without manual MCP setup.

[Set up the Codex plugin](docs/mcp.md#codex-plugin).

### Other MCP tools

[](#other-mcp-tools)

Other compatible AI tools can use the same focused, read-only profile data through optional Model Context Protocol (MCP) support. Follow the [MCP setup guide](docs/mcp.md) for Claude Code, Cursor, VS Code, and other local MCP clients.

Requirements
------------

[](#requirements)

- PHP 8.1 or newer
- Laravel 10 or newer

Install
-------

[](#install)

Until v1 is tagged, install the current development version:

```
composer require --dev newdebugbar/newdebugbar:dev-main
```

Laravel loads it for you. Visit your app in the `local` environment. The bar will appear at the bottom of the page.

New Debug Bar uses Livewire 4 for its own interface. Your app does not need to use Livewire. Apps that already use Livewire 3 are not supported.

Keep the package in `require-dev` so it is not installed in production.

Settings
--------

[](#settings)

The package works without any setup. To change its settings, publish the config file:

```
php artisan vendor:publish --tag=newdebugbar-config
```

To turn the bar off, add this to `.env`:

```
NEWDEBUGBAR_ENABLED=false
```

Your data
---------

[](#your-data)

The package runs only in the `local` environment by default. It saves short-lived profile files in `storage/framework/newdebugbar`. It does not need a database.

Common secrets are hidden. The package does not call an AI service or change your app's data.

Work on the package
-------------------

[](#work-on-the-package)

```
composer install
npm install
npm run build
composer test
```

License
-------

[](#license)

New Debug Bar uses the Apache License 2.0.

###  Health Score

26

—

LowBetter than 40% of packages

Maintenance65

Regular maintenance activity

Popularity17

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

 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.

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/3613731?v=4)[Benjamin Crozat](/maintainers/benjamincrozat)[@benjamincrozat](https://github.com/benjamincrozat)

---

Top Contributors

[![benjamincrozat](https://avatars.githubusercontent.com/u/3613731?v=4)](https://github.com/benjamincrozat "benjamincrozat (159 commits)")

---

Tags

laravel

### Embed Badge

![Health badge](/badges/newdebugbar-newdebugbar/health.svg)

```
[![Health](https://phpackages.com/badges/newdebugbar-newdebugbar/health.svg)](https://phpackages.com/packages/newdebugbar-newdebugbar)
```

PHPackages © 2026

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