crustum/speculum

CakePHP Speculum, debug assistant for your CakePHP application

dev-main 2026-07-25 22:09 UTC

Requires

• php: >=8.2
• cakephp/cakephp: ^5.2
• cakephp/queue: ^2.0
• crustum/mcp: dev-main
• crustum/plugin-manifest: ^1.0
• symfony/polyfill-php84: ^1.31
• symfony/var-dumper: ^7.0|^8.0

Requires (Dev)

• cakephp/cakephp-codesniffer: ^5.0
• cakephp/migrations: ^5.0
• crustum/batch-queue: ^1.1
• crustum/broadcasting: ^1.3
• crustum/essentia: ^1.0
• crustum/notification: ^1.0
• phpstan/phpstan: ^2.0
• phpunit/phpunit: ^10.5 || ^11.1 || ^12.5
• rector/rector: ^2.5

Suggests

• ext-mongodb: Enable soft MongoDB command watcher (CommandSubscriber APM)
• crustum/batch-queue: Enable batch watcher
• crustum/blazecast: Enable blazecast watcher
• crustum/broadcasting: Soft broadcast tags on events
• crustum/cakephp-scheduling: Enable schedule watcher
• crustum/notification: Enable notification watcher
• crustum/speculum-mongo: Demo extension panel for Mongo (optional; core soft watcher preferred)
• josegonzalez/cakephp-queuesadilla: Enable Queuesadilla job watcher

MIT

• Evgeny Tomenko

• debugging
• cakephp
• monitoring
• speculum

Published on Packagist.org on 2026-07-25 22:09 UTC

README

The Speculum plugin is a debug assistant for CakePHP applications. It records requests, exceptions, logs, database queries, queued jobs, mail, notifications, cache operations, scheduled tasks, HTTP client calls, and related runtime activity into a searchable dashboard.

Speculum tags entries and groups them by request batch so you can follow a full request story. Soft dependencies enable watchers for batches, notifications, scheduling, and broadcasting when those packages are present. Dashboard access is owned by the host application.

The plugin also exposes a dedicated MCP server (cake-speculum) with several tools so AI agents can search and inspect recorded entries without opening the UI.

Requirements

• PHP 8.4+
• crustum/mcp

See Versions.md for the supported CakePHP versions.

Documentation

For documentation, as well as tutorials, see the docs directory of this repository.

License

Licensed under the MIT License. Redistributions of the source code included in this repository must retain the copyright notice found in each file.