Dirigera Control (IKEA smart home)

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.

Security Scan

The skill's code and instructions are consistent with its stated purpose (discovering a local IKEA Dirigera hub, generating a local API token, and controlling devices); it requests no unrelated credentials or installs arbitrary remote code.

Purpose & Capability

Name/description (Dirigera hub control) match the included scripts and documentation: subnet scanning, token generation (OAuth PKCE flow), and device control via the 'dirigera' Python library. Nothing in the package requests unrelated cloud credentials or services.

Instruction Scope

Runtime instructions and scripts stay within the scope of discovering a local hub, waiting for a physical button press, saving a locally-created token, and then controlling devices. They do perform LAN scanning (ARP parsing and TCP probes on a subnet) and may invoke local subprocesses (e.g., generate-token). This is coherent for hub discovery but is network-probing behavior users should be aware of.

Install Mechanism

No packaged install step is included (instruction-only install). The README asks the user to pip install the 'dirigera' library and the generate-token wrapper imports 'requests' and exits if missing. There are no downloads from untrusted URLs or archive extraction steps in the skill.

Credentials

The skill declares no required environment variables or credentials. Token generation writes an access token to a local file by default (dirigera_token.txt) — this is necessary for operation but is sensitive and documented. No unrelated secrets or system credentials are requested.

Persistence & Privilege

The skill is not always-enabled and does not request elevated/persistent platform privileges. It uses local files to store the token (user-configurable) and does not modify other skills or system-wide agent settings.

Assessment

This skill appears to do what it says: find a Dirigera hub on your LAN, guide a user through pressing the hub's action button, save the resulting token locally, and control devices via the 'dirigera' Python library. Before installing/using it: - Run the scripts only on a trusted machine on the same LAN as your Dirigera hub. The find_dirigera_ip script performs ARP parsing and TCP probes across the local subnet — expected for discovery but consider network policies if you're on a managed network. - The token generation saves an access token to a local file (default: dirigera_token.txt). Treat that file as sensitive: choose a safe output path, restrict filesystem permissions, and delete it when no longer needed. - The generate-token wrapper disables SSL verification (verify=False) and suppresses warnings to work with the hub's local certificate; this is necessary for local hub interaction but be aware it skips TLS validation for the hub endpoint only. - The description mentions a Cloudflare tunnel on a VPS; the skill does not install or configure any tunnel. Exposing your hub to the Internet via tunnels is outside the scope of these scripts and increases risk — do not expose the hub unless you understand the implications and secure the tunnel. - Inspect and run the code in an isolated environment (virtualenv) and audit network activity if you have concerns. If you need higher assurance, review the 'dirigera' PyPI package source before installing. Overall: coherent and consistent with its purpose, but handle the generated token and any decision to expose the hub to the internet with care.

IKEA Dirigera Smart Home Control

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

Prerequisites

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).

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:

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:

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 - do not wait or continue processing
2. Tell the user: "I've started the token generation process. Please press the ACTION BUTTON on the bottom of your Dirigera hub now. Let me know when you've pressed it."

Step 3: Wait for User Confirmation

The user will:

1. Physically press the button on their Dirigera hub
2. Reply to you confirming they pressed it (e.g., "Done" or "Pressed")

The script will automatically detect the button press and save the token to the file.

Step 4: Retrieve the Saved Token

After the user confirms, read the token from the file:

from pathlib import Path
token = Path("dirigera_token.txt").read_text().strip()

Or from a custom location:

TOKEN=$(cat /path/to/token.txt)

Then use the token to connect:

import dirigera
hub = dirigera.Hub(token=token, ip_address="<dirigera-ip>")

Alternative: Manual Command

For manual use (not recommended for agents):

generate-token <dirigera-ip-address>

This requires interactive terminal access and doesn't save output automatically.

Troubleshooting

If you cannot find the hub IP address:

1. Check the router/DHCP list and look for "Dirigera".
2. If the name is missing, match the hub's MAC address label to a new device entry.
3. Ensure the hub and client are on the same network.
4. If you have candidate IPs, run generate-token against them until one succeeds.
5. If you already have a token, run python scripts/find_dirigera_ip.py --token <dirigera-token>.
6. If everything else fails, run python scripts/find_dirigera_ip.py --try-generate-token and follow the prompt.

Hub Connection

import dirigera

hub = dirigera.Hub(
    token="token",
    ip_address="ip_address"
)

CRITICAL: Attribute Access

Device state is in .attributes, not top-level.

# CORRECT
light.attributes.is_on
light.attributes.light_level

# WRONG - raises AttributeError
light.is_on
light.light_level

Top-level: device.id, device.is_reachable, device.room State: device.attributes.is_on, device.attributes.light_level

Quick Commands

Discovery

lights = hub.get_lights()
outlets = hub.get_outlets()
controllers = hub.get_controllers()
scenes = hub.get_scenes()

Light Control

light = hub.get_light_by_name(lamp_name="bedroom light")

# Check reachability first
if light.is_reachable:
    light.set_light(lamp_on=True)
    light.set_light_level(light_level=75)
    light.set_color_temperature(color_temp=2700)  # Warm white

# Reload after changes
light.reload()

Outlet Control

outlet = hub.get_outlet_by_name(outlet_name="living room")
outlet.set_on(outlet_on=True)
outlet.reload()

Scene Triggering

scene = hub.get_scene_by_name(scene_name="Sove tid")
scene.trigger()

Check Capabilities

# Verify device supports feature before using
if 'colorTemperature' in light.capabilities.can_receive:
    light.set_color_temperature(color_temp=3000)

Common Patterns

See references/patterns.md for room-based control, batch operations, status reports, and battery monitoring.

Helper Scripts

Use scripts/helpers.py for common operations: get lights by room, check battery levels, find unreachable devices.

Complete Reference

See references/api.md for:

• Complete attribute reference
• All control methods
• Device capabilities
• Color temperature/hue values
• Troubleshooting

Best Practices

1. Always check device.is_reachable before control
2. Call device.reload() after control commands
3. Use .attributes for all state access
4. Add 0.5s delays between rapid commands
5. Check capabilities before using features