Vibe documents

README.md

@@ -1,2 +1,19 @@
-# chill
+# Chill
 
+Zephyr RTOS firmware with mode control, addressable LEDs, PWM bar, IMU, and ambient light sensing. Config is persisted to flash via NVS.
+
+## Shell Commands
+
+All commands are available over the Zephyr shell (USB).
+
+### `mode`
+
+| Command | Args | Description |
+|---|---|---|
+| `mode set` | `<phase_a_ms> <phase_b_ms>` | Set phase durations, save to flash, and restart |
+| `mode color` | `<name>` | Set LED color by name, save to flash, and restart |
+| `mode duration` | `<ms>` | Set color animation duration, save to flash, and restart |
+| `mode status` | — | Print current config (phases, color, duration) |
+| `mode colors` | — | List all available color names with RGB values |
+
+> See [DEBUG.md](DEBUG.md) for development/test commands.