# Nanoleaf

> Control Nanoleaf light panels via the Picoleaf CLI. Use for turning Nanoleaf on/off, adjusting brightness, setting colors (RGB/HSL), changing color temperature, or any Nanoleaf lighting control.

- Skill: `kbarbel640-del/nanoleaf` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add kbarbel640-del/nanoleaf`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kbarbel640-del/nanoleaf/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: kbarbel640-del (https://skillmd.com/u/kbarbel640-del)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/kbarbel640-del/nanoleaf

---


# Picoleaf CLI

Use `picoleaf` to control Nanoleaf light panels.

Setup
1. Find Nanoleaf IP: Check router or use mDNS: `dns-sd -Z _nanoleafapi`
2. Generate token: Hold power button 5-7 sec until LED flashes, then within 30 sec run:
   `curl -iLX POST http://<ip>:16021/api/v1/new`
3. Create config file `~/.picoleafrc`:
   ```ini
   host=<ip>:16021
   access_token=<token>
   ```

Power
- `picoleaf on` - Turn on
- `picoleaf off` - Turn off

Brightness
- `picoleaf brightness <0-100>` - Set brightness percentage

Colors
- `picoleaf rgb <r> <g> <b>` - Set RGB color (0-255 each)
- `picoleaf hsl <hue> <sat> <light>` - Set HSL color
- `picoleaf temp <1200-6500>` - Set color temperature in Kelvin

Examples
- Warm dim light: `picoleaf on && picoleaf brightness 30 && picoleaf temp 2700`
- Bright blue: `picoleaf on && picoleaf brightness 100 && picoleaf rgb 0 100 255`
- Turn off: `picoleaf off`

Notes
- Default port is 16021
- Token generation requires physical access to the Nanoleaf controller
- Multiple commands can be chained with `&&`