dirigera-control

---
name: dirigera-control
description: Control IKEA Dirigera smart home devices (lights, outlets, scenes, controllers). Use when the user asks to control smart home devices, check device status, turn lights on/off, adjust brightness/color, control outlets, trigger scenes, check battery levels, or work with IKEA smart home automation. Also use when the user needs help finding the Dirigera hub IP address or generating an API token. Accessible via Cloudflare tunnel on VPS.
---

# IKEA Dirigera Smart Home Control

Control lights, outlets, scenes, and other IKEA smart home devices through the Dirigera hub.

## Prerequisites

```python
pip install dirigera
```

## Hub Setup

### Find Hub IP

Check the router/DHCP client list for "Dirigera" and note its IP address.

If the agent is on the same LAN, try the IP discovery script. It can:
1. Scan the subnet for likely candidates (no token required).
2. Verify the exact hub IP if a token is available.
3. As a last resort, try `generate-token` against candidates (interactive).

```bash
python scripts/find_dirigera_ip.py
# or
python scripts/find_dirigera_ip.py --subnet 192.168.1.0/24
# verify with token (if you have it)
python scripts/find_dirigera_ip.py --token <dirigera-token>
# last resort: try generate-token against candidates
python scripts/find_dirigera_ip.py --try-generate-token
```

### Generate Token

**IMPORTANT**: Token generation REQUIRES PHYSICAL USER ACTION. Follow this workflow:

#### Step 1: Start Token Generation Script
Run the wrapper script in the background. It will automatically wait for the button press:

```bash
python scripts/generate_token_wrapper.py <dirigera-ip-address> &
```

The token will be saved to `dirigera_token.txt` by default. To specify a custom location:

```bash
python scripts/generate_token_wrapper.py <dirigera-ip-address> --output /path/to/token.txt &
```

#### Step 2: **END YOUR TURN AND INFORM THE USER**
**CRITICAL**: After starting the script, you MUST:
1. **End your turn immediately**