LaraStatus

Live Laravel project metrics in your VS Code status bar.

LaraStatus adds a real-time ticker to your VS Code footer bar showing the health of your Laravel project at a glance — test results, pending migrations, route count, TODOs, git stats, environment warnings and more.

Preview

$(flame) PRODUCTION  |  $(git-branch) main  |  $(diff) 143 lines today  |  $(history) 2 hours ago  |  $(error) 2 failing  |  $(warning) 3 pending  |  $(list-unordered) 47 routes  |  $(note) 12 todos

Rendered in VS Code:

🔥 PRODUCTION  ⋮  git-branch main  ⋮  ± 143 lines today  ⋮  ↺ 2 hours ago  ⋮  ✗ 2 failing  ⋮  ⚠ 3 pending  ⋮  ≡ 47 routes  ⋮  📝 12 todos

Hover over the status bar for a detailed Markdown tooltip. Click to manually refresh.

Features

• Git metrics — current branch, lines changed today, time since last commit
• Test results — pass/fail count via php artisan test
• Pending migrations — count via php artisan migrate:status
• Route count — total registered routes via php artisan route:list
• TODO / FIXME count — grepped across app/, resources/, routes/
• Environment warning — highlights $(flame) PRODUCTION when APP_ENV=production
• Composer outdated — optional count of packages with available updates
• Click to refresh — instant manual refresh from the status bar
• File watcher triggers — auto-refreshes on PHP saves, migration changes, .env edits
• Per-metric toggles — show only what you care about via VS Code settings

Requirements

• VS Code ^1.85.0
• PHP available in $PATH
• A Laravel project (detected by presence of artisan in the workspace root)
• Composer (only required if showComposerOutdated is enabled)

Installation

From the VS Code Marketplace

1. Open VS Code
2. Press Ctrl+P (or Cmd+P on Mac)
3. Type ext install Phoenix1331.larastatus
4. Press Enter

Or search LaraStatus in the Extensions panel (Ctrl+Shift+X).

From a .vsix file

code --install-extension larastatus-0.1.0.vsix

Configuration

All settings are under the larastatus namespace. Open your settings.json and add any of the following:

Example settings.json

{
  "larastatus.enabled": true,
  "larastatus.refreshInterval": 60,
  "larastatus.showTests": true,
  "larastatus.showMigrations": true,
  "larastatus.showRoutes": false,
  "larastatus.showTodos": true,
  "larastatus.showGitBranch": true,
  "larastatus.showGitChanges": true,
  "larastatus.showLastCommit": true,
  "larastatus.showEnvWarning": true,
  "larastatus.showComposerOutdated": false
}

Usage

• LaraStatus activates automatically when a Laravel project is detected (presence of artisan in the workspace root)
• Metrics refresh on the configured interval
• Click the status bar item to refresh immediately
• Hover over the status bar item for a detailed tooltip
• Metrics also refresh automatically when you save PHP files, modify migrations, or edit .env

Screenshots

Status bar — normal state:

Status bar — production warning + failing tests:

Hover tooltip:

To add screenshots: drop your .png files into the images/ folder and push to the repo. Suggested filenames above match the references in this README.

Future Features

Community contributions are very welcome. Here are planned additions for future versions:

• [ ] Click-through panels — click individual metrics to open a detail panel (e.g. list failing tests, list pending migrations)
• [ ] Pest support — detect and use Pest as the test runner when installed
• [ ] Multi-root workspace support — show metrics per workspace folder
• [ ] Queue metrics — show failed jobs count from failed_jobs table
• [ ] Cache driver indicator — show active cache/session drivers from .env
• [ ] Horizon status — show Laravel Horizon running/paused/stopped status
• [ ] Telescope integration — show recent exception count from Telescope
• [ ] NPM/Vite metrics — show outdated npm packages or last build time
• [ ] Custom metric plugins — allow extensions to register their own metric providers
• [ ] Notification alerts — pop-up when tests go from passing to failing
• [ ] Status bar colour theming — red bar when in production or tests failing
• [ ] Inertia / Livewire detection — surface component counts or stats

If you'd like to contribute, see CONTRIBUTING.md.

License

MIT — see LICENSE

Built by Darren Williams