Device Control Skill

Control device volume, brightness, and applications via command line. Supports Linux, macOS, Windows, and WSL.

Security

All inputs are validated and sanitized to prevent command injection:

• Volume/brightness values must be numbers between 0-100
• App names are restricted to alphanumeric characters, spaces, dashes, and underscores
• Shell metacharacters are blocked

Tool API

device_control

Execute a device control action.

• Parameters:
  • action (string, required): One of set_volume, change_volume, set_brightness, open_app, close_app.
  • value (string/number, optional): The value for the action (0-100 for volume/brightness, delta for change_volume).
  • app (string, optional): The application name or path (required for open/close actions).

Usage:

# Set volume to 50%
node skills/device-control/ctl.js --action set_volume --value 50

# Change volume by +10 or -10
node skills/device-control/ctl.js --action change_volume --value 10
node skills/device-control/ctl.js --action change_volume --value -10

# Set brightness to 75%
node skills/device-control/ctl.js --action set_brightness --value 75

# Open an application
node skills/device-control/ctl.js --action open_app --app "firefox"
node skills/device-control/ctl.js --action open_app --app "Visual Studio Code"

# Close an application
node skills/device-control/ctl.js --action close_app --app "firefox"

Platform Support

Requirements

• Linux: pactl (PulseAudio) or amixer (ALSA), brightnessctl (optional, for brightness)
• macOS: Built-in osascript, brightness CLI tool (optional, for brightness)
• Windows/WSL: nircmd.exe for volume control (download from nirsoft.net)