artisan schedule:list
See every scheduled task, its cron expression, and next due date at a glance — stop guessing when your jobs run.
Overview
php artisan schedule:list displays a table of all registered scheduled tasks with their frequency, next run time, and description. It turns your routes/console.php schedule into a readable dashboard.
Usage
php artisan schedule:list
Output:
┌───────────────────────────────────────┬──────────────┬─────────────────────────┬──────────────┐
│ Command │ Interval │ Next Due │ Description │
├───────────────────────────────────────┼──────────────┼─────────────────────────┼──────────────┤
│ app:prune-old-records │ Daily │ 2024-01-15 00:00:00 UTC │ │
│ queue:prune-batches │ Daily │ 2024-01-15 00:00:00 UTC │ │
│ app:send-weekly-digest │ Weekly (Mon) │ 2024-01-22 09:00:00 UTC │ Weekly email │
│ telescope:prune │ Daily │ 2024-01-15 00:00:00 UTC │ │
└───────────────────────────────────────┴──────────────┴─────────────────────────┴──────────────┘
There's also schedule:test to run a specific scheduled task interactively:
php artisan schedule:test
This prompts you to pick a task from the list and runs it immediately — great for testing without waiting for the cron schedule.
When to Use
- Verifying your schedule is correctly configured after changes
- Debugging why a task isn't running (wrong frequency, missing registration)
- Onboarding — quickly understand what background work an app performs
- Confirming "next due" times are correct after timezone changes