CLI Reference

Reference for common Glueful CLI commands

This reference focuses on commands that exist in the current framework and starter app.

Basics

php glueful
php glueful help serve
php glueful list

Setup

php glueful install
php glueful generate:key
php glueful doctor
php glueful system:check

Development Server

php glueful serve
php glueful serve --host=0.0.0.0 --port=9000
php glueful serve --watch

Database

php glueful migrate:create CreateUsersTable
php glueful migrate:run
php glueful migrate:rollback
php glueful migrate:status

php glueful db:status
php glueful db:profile
php glueful db:reset
php glueful db:seed

Scaffolding

php glueful scaffold:controller UserController
php glueful scaffold:model User
php glueful scaffold:request CreateUserRequest
php glueful scaffold:middleware EnsureAdmin
php glueful scaffold:job SendWelcomeEmail
php glueful scaffold:test UserControllerTest
php glueful scaffold:factory UserFactory
php glueful scaffold:seeder UserSeeder
php glueful scaffold:resource UserResource
php glueful scaffold:rule StrongPassword
php glueful scaffold:filter UserFilter

Cache

php glueful cache:get some:key
php glueful cache:set some:key "value" --ttl=3600
php glueful cache:delete some:key
php glueful cache:expire some:key 120
php glueful cache:ttl some:key
php glueful cache:inspect some:key
php glueful cache:status
php glueful cache:clear
php glueful cache:purge          # extension: glueful/cdn (edge/CDN purge; absent in core)
php glueful cache:maintenance

cache:purge is provided by the glueful/cdn extension (framework 1.52.0+), not core. Without the extension it is not registered. Restore with composer require glueful/cdn.

Queue

php glueful queue:work                       # lean single worker
php glueful queue:work --once                # process one job then exit
php glueful queue:work --connection=redis    # pick the queue connection
php glueful queue:scheduler

php glueful queue:autoscale                  # extension: glueful/queue-ops (not core)
php glueful queue:supervise                  # extension: glueful/queue-ops (not core)

Core queue:work is a lean single worker (flags: --once, --connection; 0 = unlimited). The old queue:work sub-actions (work/spawn/scale/status/stop/restart/health/process), queue:autoscale, and queue:supervise moved to the glueful/queue-ops extension in framework 1.52.0. Restore with composer require glueful/queue-ops.

OpenAPI / Docs

php glueful generate:openapi

Routing / Container

php glueful route:debug
php glueful route:cache:status
php glueful route:cache:clear

php glueful di:container:debug
php glueful di:container:validate
php glueful di:container:compile
php glueful di:container:map
php glueful di:lazy:status

Field Selection

php glueful fields:analyze            # analyze field-selection usage across routes
php glueful fields:validate           # validate #[Fields] whitelists
php glueful fields:performance        # benchmark field-selection projection
php glueful fields:whitelist-check    # check requests against route whitelists

Configuration

php glueful config:dsn:validate --from-env    # validate DB/Redis DSNs (or --db=... / --redis=...)

Extensions

php glueful create:extension Billing
php glueful extensions:list
php glueful extensions:info billing
php glueful extensions:enable billing
php glueful extensions:disable billing
php glueful extensions:cache
php glueful extensions:clear
php glueful extensions:summary
php glueful extensions:diagnose

extensions:enable / extensions:disable accept a package name, provider FQCN, or slug (case-insensitive), validate the change before writing to config/extensions.php, and recompile the cache. extensions:list shows each extension's state (enabled ✓ / available ○ / enabled-but-missing ⚠). In production, manage the enabled list in config and run extensions:cache during deploy.

Security / Auth

php glueful security:check
php glueful security:scan
php glueful security:report
php glueful security:vulnerabilities
php glueful security:lockdown
php glueful security:revoke-tokens

Permissions

php glueful permissions:list
php glueful permissions:diff
php glueful permissions:sync

Other Useful Commands

php glueful webhook:list
php glueful webhook:test
php glueful webhook:retry

php glueful api:version:list
php glueful api:version:deprecate

php glueful notifications:process-retries
php glueful archive:manage    # extension: glueful/archive (not core)
php glueful test:watch
php glueful version

archive:manage is provided by the glueful/archive extension (framework 1.52.0+), not core. Restore with composer require glueful/archive + php glueful migrate:run.

Notes

Older command names such as generate:controller, generate:api-definitions, and generate:api-docs should not be used unless they exist in your installed version.
For most new app code generation, prefer the scaffold:* commands.
Deploy after upgrading to 1.52.0: this release removed cache:purge, archive:manage, and queue:autoscale from core. A stale production command manifest (storage/cache/glueful_commands_manifest.php) breaks CLI boot, so run php glueful commands:cache --clear on deploy. cache:clear does not clear the command manifest.

API Reference

Quick reference for common framework surfaces

Extensions

Official Glueful extensions for identity/accounts, RBAC, multi-tenancy, SSO, email, push, SMS/WhatsApp, search, payments, and runtime integrations.