CLI Commands

ADP provides console commands for managing the debug system. All commands are built on Symfony Console and available through your framework's CLI runner or the standalone debug:serve server.

Available Commands

dev -- Debug Server

Starts a UDP socket server that receives real-time debug messages from the application.

php yii dev                         # Default: 0.0.0.0:8890
php yii dev -a 127.0.0.1 -p 9000   # Custom address and port

The server receives and displays three message types:

• Variable dumps (MESSAGE_TYPE_VAR_DUMPER)
• Log messages (MESSAGE_TYPE_LOGGER)
• Plain text messages

Supports graceful shutdown via SIGINT (Ctrl+C).

debug:reset -- Clear Debug Data

Stops the debugger and clears all stored debug data.

php yii debug:reset

Internally calls DebuggerAppDevPanel\Kernel\DebuggerClass Debugger.final Kernel · class::stop() followed by StorageInterfaceAppDevPanel\Kernel\Storage\StorageInterfaceDebug data storage responsibility is to store debug data from collectors addedKernel · interface::clear().

dev:broadcast -- Broadcast Test Messages

Sends test messages to all connected debug server clients. Useful for verifying connectivity.

php yii dev:broadcast                    # Default: "Test message"
php yii dev:broadcast -m "Hello world"   # Custom message

debug:query -- Query Debug Data

Query stored debug data from the command line.

debug:query list                          # List recent entries (default 20)
debug:query list --limit=5                # Limit entries
debug:query list --json                   # Raw JSON output
debug:query view <id>                     # Full entry data
debug:query view <id> -c <CollectorFQCN>  # Specific collector data

debug:serve -- Standalone ADP Server

Starts a standalone HTTP server using PHP's built-in server, serving the ADP API directly. No framework required.

debug:serve                                       # Default: 127.0.0.1:8888
debug:serve --host=0.0.0.0 --port=9000            # Custom host/port
debug:serve --storage-path=/path/to/debug/data    # Custom storage directory
debug:serve --frontend-path=/path/to/built/assets # Serve frontend assets

mcp:serve -- MCP Server (stdio)

Starts the MCP server in stdio mode for AI assistant integration. See the MCP Server page for details.

php yii mcp:serve --storage-path=/path/to/debug-data

Command Summary

Command	Purpose
dev	Start real-time UDP debug server
debug:reset	Clear all stored debug data
dev:broadcast	Send test messages to debug server
debug:query	Query stored entries from CLI
debug:serve	Start standalone HTTP API server
mcp:serve	Start MCP server (stdio transport)