flights

What This Skill Does

The flights (fox-lights) skill is a specialized command-line interface tool designed to bring smart lighting control directly into your terminal environment. Specifically engineered for Tuya-compatible smart bulbs using the v3.3 protocol, this skill acts as a localized bridge between your computer and your smart home hardware. Unlike standard apps that rely on cloud servers, flights communicates directly within your local network, ensuring that your lighting commands are executed with minimal latency and enhanced privacy.

By leveraging a centralized configuration file located at ~/.config/flights/bulbs.json, the skill allows you to manage multiple light sources seamlessly. You can organize, identify, and trigger specific bulbs by name, providing a streamlined workflow for developers, system administrators, or anyone who prefers CLI-based automation over graphical interfaces.

Installation

To install this skill via OpenClaw, execute the following command in your terminal: clawhub install openclaw/skills/skills/brewthefox/fox-lights. Once installed, verify the setup by running flights --help. If the help menu appears, you are ready to configure your devices. To add a light, ensure you have your Tuya local key (16 characters) and device ID (22 characters) on hand, then use the flights add command to register your bulb with its respective IP address.

Use Cases

This tool is ideal for home office setups where lighting needs to change based on specific coding sessions or development environments. For instance, you could script the lights to turn red when a build fails or soft white during a deep-focus session. It is also perfect for users seeking to build custom dashboard widgets or shell scripts that sync smart lighting states with system events, such as turning off all lights when the computer goes to sleep or dims the lights when a media player starts.

Example Prompts

1. "Turn on the office light to 50% brightness and set it to a warm white."
2. "Change the living room light to hex color #FF5733 for my evening reading session."
3. "Check the current status of the kitchen light to see if it's currently on or off."

Tips & Limitations

• Configuration: Always keep a backup of your ~/.config/flights/bulbs.json file. If you accidentally delete or corrupt it, you will need to re-add your devices manually.
• Network Stability: Since this tool relies on local IP addresses, ensure your bulbs have static IP reservations in your router settings. If a bulb's IP changes, the skill will lose connectivity.
• Key Management: The Tuya local key is dynamic; if your bulb unlinks from the Tuya account, the key may change, requiring an update in your config file.
• Compatibility: This tool is strictly for Tuya v3.3 devices. It will not communicate with non-Tuya Zigbee or Bluetooth devices without a compatible gateway integration.