PHPackages                             tegos/laravel-telescope-flusher - 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 & Profiling](/categories/debugging)
4. /
5. tegos/laravel-telescope-flusher

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

tegos/laravel-telescope-flusher
===============================

telescope-flusher is a Laravel package that provides a simple Artisan command to completely flush all Telescope data from the database

v1.0.3(2mo ago)51.4k↓23.8%MITPHPPHP ^8.1CI passing

Since Mar 10Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/tegos/laravel-telescope-flusher)[ Packagist](https://packagist.org/packages/tegos/laravel-telescope-flusher)[ Docs](https://github.com/tegos/laravel-telescope-flusher)[ RSS](/packages/tegos-laravel-telescope-flusher/feed)WikiDiscussions main Synced yesterday

READMEChangelog (3)Dependencies (4)Versions (9)Used By (0)

   ![Laravel Telescope Flusher Banner](assets/banner-light.webp)

 [![Latest Version on Packagist](https://camo.githubusercontent.com/98cc2c1cb913cf5968c8287acfec4e2d5276b22d386b8283f81dea124b2d1137/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7465676f732f6c61726176656c2d74656c6573636f70652d666c75736865722e737667)](https://packagist.org/packages/tegos/laravel-telescope-flusher) [![Total Downloads](https://camo.githubusercontent.com/d33b92c47344d8ccd3eb5339fe0f2c82bd4d8523ae49fbdfbd429fd7249de23f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7465676f732f6c61726176656c2d74656c6573636f70652d666c75736865722e737667)](https://packagist.org/packages/tegos/laravel-telescope-flusher) [![Tests](https://github.com/tegos/laravel-telescope-flusher/actions/workflows/tests.yml/badge.svg)](https://github.com/tegos/laravel-telescope-flusher/actions/workflows/tests.yml) [![PHP Version](https://camo.githubusercontent.com/83dd395020c37276225039739320f6c8e7e99963ab21ee3d09282cb48dad2a60/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e312532422d626c7565)](https://www.php.net/) [![Laravel Version](https://camo.githubusercontent.com/a630ece5812527f4b99ff645feee9b18a061c8caeaae2784e38a4faac1426b8c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d31302532422d627269676874677265656e)](https://laravel.com/) [![Software License](https://camo.githubusercontent.com/074b89bca64d3edc93a1db6c7e3b1636b874540ba91d66367c0e5e354c56d0ea/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e737667)](LICENSE.md)

---

**Laravel Telescope Flusher** is a Laravel package providing an Artisan command that completely wipes all Telescope data and reclaims disk space. Unlike `telescope:prune` (which deletes by age), it truncates every Telescope table and runs `OPTIMIZE TABLE` on MySQL to release storage back to the engine.

Useful when `telescope_entries` grows to multi-GB sizes from heavy jobs or long development sessions.

 [![telescope:clear vs telescope:flush, 1M entries benchmark](assets/flush-demo.gif)](assets/flush-demo.gif)

> Benchmark on 1,000,000 entries / 3,000,000 tags (MySQL 8.0): `telescope:clear` takes ~150 minutes and leaves 3.1 GB locked in `.ibd` files. `telescope:flush` finishes in 1.21 seconds and shrinks the files to 428 KB. Reproduction script in [`bench/`](bench/).

Read more:

- [Why `telescope:clear` Is Slow and How to Reclaim Disk in Seconds](https://dev.to/tegos/why-telescopeclear-is-slow-and-how-to-reclaim-disk-in-seconds-26of) - the benchmark deep-dive
- [Efficiently Managing Telescope Entries with Laravel-Telescope-Flusher](https://dev.to/tegos/efficiently-managing-telescope-entries-with-laravel-telescope-flusher-484a) - the original post

Installation
------------

[](#installation)

**Requirements:** PHP 8.1+ · Laravel 10/11/12/13 · `laravel/telescope` installed (MySQL, PostgreSQL, SQLite supported).

You can install the package via Composer:

```
composer require tegos/laravel-telescope-flusher --dev
```

Usage
-----

[](#usage)

Once installed, you can run the following command to flush Telescope data:

```
php artisan telescope:flush
```

Behavior
--------

[](#behavior)

- Only runs in **local** environments (prevents accidental execution in production).
- Checks if **Telescope is installed** before running.
- Truncates all Telescope-related tables.
- Optimizes the `telescope_entries` table (MySQL).

> Compared to `telescope:prune` (deletes rows older than `--hours`) and `telescope:clear` (slow row-by-row `DELETE`), `telescope:flush` uses `TRUNCATE` for speed and `OPTIMIZE TABLE` to reclaim disk. InnoDB does not return space to the OS after `DELETE`; it only marks it reusable.

Testing
-------

[](#testing)

You can run tests using:

```
composer test
```

### Running tests in Docker

[](#running-tests-in-docker)

```
docker compose up -d
docker compose exec app composer install
docker compose exec app composer test
```

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for contribution guidelines.

Security
--------

[](#security)

If you discover any security-related issues, please email **** instead of using the issue tracker.

Credits
-------

[](#credits)

- **[Ivan Mykhavko](https://github.com/tegos)**
- **[All Contributors](../../contributors)**

License
-------

[](#license)

This package is open-source software licensed under the **MIT License**. See [LICENSE](LICENSE.md) for details.

---

 [ ![Donate](./assets/come-back-alive.svg) ](https://savelife.in.ua/en/donate-en/)

###  Health Score

45

—

FairBetter than 91% of packages

Maintenance85

Actively maintained with recent releases

Popularity24

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity52

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 ~98 days

Total

5

Last Release

88d ago

Major Versions

0.x-dev → v1.0.02025-03-10

PHP version history (2 changes)0.x-devPHP ^8.0

v1.0.1PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/ac0c59fc98164ed889f568f35386bb93f4f81431e00b2c24104ae69a198d15a2?d=identicon)[tegos](/maintainers/tegos)

---

Top Contributors

[![tegos](https://avatars.githubusercontent.com/u/7047662?v=4)](https://github.com/tegos "tegos (19 commits)")

---

Tags

cleanerdebugginglaravelphptegoslaravel-telescope-flusher

### Embed Badge

![Health badge](/badges/tegos-laravel-telescope-flusher/health.svg)

```
[![Health](https://phpackages.com/badges/tegos-laravel-telescope-flusher/health.svg)](https://phpackages.com/packages/tegos-laravel-telescope-flusher)
```

###  Alternatives

[spatie/laravel-pdf

Create PDFs in Laravel apps

1.0k4.8M47](/packages/spatie-laravel-pdf)[psalm/plugin-laravel

Psalm plugin for Laravel

3355.3M346](/packages/psalm-plugin-laravel)[spatie/laravel-ray

Easily debug Laravel apps

31841.3M3.5k](/packages/spatie-laravel-ray)[laravel/ai

The official AI SDK for Laravel.

1.0k3.2M194](/packages/laravel-ai)[moonshine/moonshine

Laravel administration panel

1.3k253.1k81](/packages/moonshine-moonshine)[illuminate/console

The Illuminate Console package.

13046.0M6.5k](/packages/illuminate-console)

PHPackages © 2026

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