PHPackages                             timmcleod/agent-workflows-ui - 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. [Logging & Monitoring](/categories/logging)
4. /
5. timmcleod/agent-workflows-ui

ActiveLibrary[Logging & Monitoring](/categories/logging)

timmcleod/agent-workflows-ui
============================

A dashboard for timmcleod/agent-workflows — visualize runs, approve interrupts, and retry failures from the browser.

v0.3.0(today)014↑2900%MITBladePHP ^8.3CI passing

Since Jul 28Pushed todayCompare

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

READMEChangelog (6)Dependencies (8)Versions (7)Used By (0)

Agent Workflows UI
==================

[](#agent-workflows-ui)

[![tests](https://github.com/timmcleod/agent-workflows-ui/actions/workflows/tests.yml/badge.svg)](https://github.com/timmcleod/agent-workflows-ui/actions/workflows/tests.yml)[![Latest Version](https://camo.githubusercontent.com/5345867bc8570c5e40c160102125c2522201935ac13bc851316b8e993f00c04e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f74696d6d636c656f642f6167656e742d776f726b666c6f77732d7569)](https://packagist.org/packages/timmcleod/agent-workflows-ui)

A dashboard for [`timmcleod/agent-workflows`](https://github.com/timmcleod/agent-workflows). Install it alongside the core package and get a live view of every workflow run: the definition rendered as a flowchart with each step's status overlaid, the step-by-step audit trail with attempts and token counts, and the checkpointed state bag.

[![The dashboard: a completed run rendered as a flowchart, the taken branch highlighted and the untaken branch dimmed, with the step-attempt audit trail alongside](https://raw.githubusercontent.com/timmcleod/agent-workflows-ui/main/art/dashboard.png)](https://raw.githubusercontent.com/timmcleod/agent-workflows-ui/main/art/dashboard.png)

One run, most of the package: this workflow took the high-risk escalation branch (the auto-approve branch dimmed as skipped), parked at the human gate — the audit trail shows the gate interrupted on attempt #1, then completed on attempt #2 after sign-off arrived via `resume()` — and finished with the summary agent. Note every step shows exactly one execution: checkpointed results are never re-run, and their tokens are never paid twice.

It is not read-only where it matters:

- **Approve from the browser.** Runs parked by `awaitHuman()` show a form generated from the step's validation schema; submitting it calls `resume()` and the run continues.
- **Retry from the checkpoint.** Failed runs get a retry button that re-runs only the failed step — earlier steps keep their results.
- **Cancel** any run that isn't already terminal.

The dashboard is plain server-rendered Blade with light polling — no build step, no assets to publish, nothing to go stale after upgrades.

> **Status: pre-release.** Tracks the pre-1.0 core package; APIs and screens may change.

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

[](#requirements)

- PHP 8.3+
- Laravel 12 or 13
- `timmcleod/agent-workflows` ^0.7

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

[](#installation)

```
composer require timmcleod/agent-workflows-ui
```

That's it — the dashboard is mounted at `/agent-workflows`.

Authorization
-------------

[](#authorization)

Like Horizon and Telescope, the dashboard is open in the `local` environment. In every other environment, all requests are refused until your application defines a `viewAgentWorkflows` gate:

```
// app/Providers/AppServiceProvider.php

use Illuminate\Support\Facades\Gate;

public function boot(): void
{
    Gate::define('viewAgentWorkflows', function ($user) {
        return $user->isAdmin();
    });
}
```

Treat access as sensitive: the dashboard exposes run state (which may contain document text and agent output) and can approve pending sign-offs.

Configuration
-------------

[](#configuration)

```
php artisan vendor:publish --tag=agent-workflows-ui-config
```

```
return [
    // URI prefix the dashboard is mounted under.
    'path' => env('AGENT_WORKFLOWS_UI_PATH', 'agent-workflows'),

    // Middleware for the dashboard routes.
    'middleware' => ['web', TimMcLeod\AgentWorkflowsUi\Http\Middleware\Authorize::class],

    // How often (ms) pages refresh their data.
    'polling' => 2500,

    // How many runs the index lists.
    'runs' => 50,
];
```

Views can be overridden the standard way: `php artisan vendor:publish --tag=agent-workflows-ui-views`.

Notes
-----

[](#notes)

- Steps execute on your queue as usual; the dashboard just observes. With a running worker you'll watch steps light up as they complete.
- Runs whose workflow is no longer registered (or whose definition has drifted since they started) still render their audit trail and state; drifted runs are badged.

License
-------

[](#license)

MIT

###  Health Score

41

—

FairBetter than 87% of packages

Maintenance100

Actively maintained with recent releases

Popularity8

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity42

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

Total

6

Last Release

0d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1099280?v=4)[Tim McLeod](/maintainers/timmcleod)[@timmcleod](https://github.com/timmcleod)

---

Top Contributors

[![timmcleod](https://avatars.githubusercontent.com/u/1099280?v=4)](https://github.com/timmcleod "timmcleod (10 commits)")

---

Tags

laravelmonitoringuiaidashboardagentsworkflows

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

Type Coverage Yes

### Embed Badge

![Health badge](/badges/timmcleod-agent-workflows-ui/health.svg)

```
[![Health](https://phpackages.com/badges/timmcleod-agent-workflows-ui/health.svg)](https://phpackages.com/packages/timmcleod-agent-workflows-ui)
```

###  Alternatives

[laravel/ai

The official AI SDK for Laravel.

1.0k3.2M250](/packages/laravel-ai)[psalm/plugin-laravel

Psalm plugin for Laravel

3345.3M348](/packages/psalm-plugin-laravel)[moonshine/moonshine

Laravel administration panel

1.3k253.1k86](/packages/moonshine-moonshine)[spatie/laravel-health

Monitor the health of a Laravel application

87912.0M177](/packages/spatie-laravel-health)[anousss007/vigilance

A driver-agnostic control center for Laravel queues, jobs, commands and the scheduler. Monitor what ran (with parameters), see failures, and dispatch jobs or run artisan commands manually from a self-contained dashboard.

1906.8k](/packages/anousss007-vigilance)[api-platform/laravel

API Platform support for Laravel

58174.6k17](/packages/api-platform-laravel)

PHPackages © 2026

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