ray-skill

The Ray skill provides a robust interface for interacting with the Spatie Ray desktop debugging application. By targeting the local Ray server at port 23517, this skill allows developers to send structured JSON payloads to visualize data, inspect variables, monitor performance, and debug application flow directly from the development environment. It supports various payload types including standard logs, custom HTML/text content, formatted data tables, and environmental modifiers like colors, labels, and entry sizes.

• Real-time logging of values, objects, and complex data structures.

• Advanced visualization capabilities including tables, custom HTML content, and screen background color modifications.

• Performance monitoring with timing measures, memory usage tracking, and automated timer management.

• Utility controls for window management such as clearing logs, showing/hiding the application, and triggering confetti animations.

• Support for multi-payload requests, allowing for grouped entries with shared metadata or specific visual modifiers.

• Seamless integration with existing PHP debugging workflows, mirroring the functionality of the native ray() function.

• The skill uses HTTP POST requests with a JSON payload structure containing unique UUIDs to maintain state and update specific Ray entries.

• Ensure the RAY_HOST and RAY_PORT environment variables are correctly configured if using a non-default setup.

• Payloads must include origin data, such as file paths and line numbers, to provide precise debugging context within the Ray window.

• Designed for Laravel and PHP developers, it serves as a powerful bridge between CLI tools and the Ray GUI for improved situational awareness during debugging sessions.

• Capable of sending desktop notifications and managing multiple screen tabs for complex debugging workflows.