Smart Home Skills

Control your physical environment directly from CLI-JAW. Smart Home skills bridge the gap between your AI assistant and IoT devices, letting you manage Philips Hue lighting and Spotify playback with natural language commands.

Overview

CLI-JAW ships with two smart home skills that connect to popular device ecosystems via their respective APIs. Both skills are implemented as MCP (Model Context Protocol) servers and are loaded on demand when the agent detects a relevant request.

openhue — Philips Hue Control

The openhue skill communicates with a Philips Hue Bridge on your local network. It exposes MCP tools for controlling individual lights, rooms, zones, and scenes.

Capabilities

Configuration

Add the openhue MCP server to your CLI-JAW settings. The bridge IP and API key are required.

{
  "mcpServers": {
    "openhue": {
      "command": "npx",
      "args": ["-y", "@openhue/mcp-server"],
      "env": {
        "OPENHUE_BRIDGE_IP": "192.168.1.100",
        "OPENHUE_API_KEY": "your-hue-api-key"
      }
    }
  }
}

To obtain your Hue API key, press the physical link button on your Hue Bridge and then run:

curl -X POST http://192.168.1.100/api \
  -d '{"devicetype":"cli-jaw#instance"}'

Natural Language Examples

How It Works

When you say something like "불 켜줘", CLI-JAW routes the request through its skill matching system:

1. The agent recognizes the intent as a smart home command
2. The openhue MCP server is loaded (if not already running)
3. The agent calls the appropriate tool (e.g., set_room with on: true)
4. The Hue Bridge executes the command and returns the updated state
5. The agent confirms the action in natural language

spotify-player — Spotify Control

The spotify-player skill connects to the Spotify Web API, giving CLI-JAW full control over music playback. It supports searching tracks, managing queues, controlling playback, and browsing playlists.

Capabilities

Configuration

Add the spotify-player MCP server with your Spotify OAuth credentials.

{
  "mcpServers": {
    "spotify-player": {
      "command": "npx",
      "args": ["-y", "spotify-player-mcp"],
      "env": {
        "SPOTIFY_CLIENT_ID": "your-client-id",
        "SPOTIFY_CLIENT_SECRET": "your-client-secret",
        "SPOTIFY_REDIRECT_URI": "http://localhost:8888/callback"
      }
    }
  }
}

OAuth Setup

1. Go to the Spotify Developer Dashboard
2. Create a new app with redirect URI http://localhost:8888/callback
3. Copy the Client ID and Client Secret into your config
4. On first use, CLI-JAW will open a browser window for Spotify authorization
5. After approval, the refresh token is cached locally for subsequent sessions

Natural Language Examples

Combined Workflows

Smart home skills become powerful when combined with each other or with other CLI-JAW capabilities. Because the agent understands context, you can issue compound commands naturally.

# Example: the agent interprets "영화 볼 준비 해줘" as:
1. openhue → set_room(room="Living Room", brightness=20)
2. openhue → set_scene(scene="Relax", room="Living Room")
3. spotify-player → pause()

Troubleshooting

Environment Variables Reference