Rebuild the adaptive "Frequently Used" section on the HA home dashboard

← Back to Tasks

OVERRIDES runtime profile: uses direct_python because this deterministic Home Assistant dashboard update script does not invoke Claude/Codex or any LLM API.

Every 6 hours. Keeps a "Frequently Used" grid at the top of the HA home dashboard, populated with the controls Elmar actually uses most.

Each run: - reads the HA logbook for user-initiated control actions only — a real person pressed it in the UI. Automation/occupancy-triggered changes and physical-switch presses are excluded (no context_user_id). - appends events to ~/workspace/state/usage_events.jsonl (HA recorder only keeps ~10 days; the ledger lets scoring span months) - scores each entity with recency-weighted decay (half-life 14 days) so controls you stop using fade out and get replaced - rewrites the top-8 grid on home view 0

Tunables in the script: TOP_N, HALF_LIFE_DAYS, LEDGER_KEEP_DAYS, CONTROL_DOMAINS, SECTION_TITLE.

Script: scripts/ha/frequently_used.py. Idempotent — finds the existing "Frequently Used" title card and replaces only the grid after it.

Schedule Every 6 hours at :000 */6 * * *

EnabledYes

Run Asshell

Timeout300s

RetryYes

Next Runin 6h (2026-06-13 12:00)

Task Definition

tasks/frequently-used.md

Run Asshell

Commandset

Tool-lessNo

BackgroundNo

Runtime profile

Notify destination

python3 /home/lucienne/workspace/scripts/ha/frequently_used.py

---
id: frequently-used
title: Rebuild the adaptive "Frequently Used" section on the HA home dashboard
schedule: "0 */6 * * *"
timeout: 300
retry: true
enabled: true
notify_on: failure
run_as: shell
command: "python3 /home/lucienne/workspace/scripts/ha/frequently_used.py"
tags: [home-assistant, dashboard, lighting]
runtime_profile: direct_python
---

**OVERRIDES runtime profile:** uses `direct_python` because this deterministic
Home Assistant dashboard update script does not invoke Claude/Codex or any LLM
API.

Every 6 hours. Keeps a "Frequently Used" grid at the top of the HA home
dashboard, populated with the controls Elmar actually uses most.

Each run:
- reads the HA logbook for **user-initiated** control actions only — a real
  person pressed it in the UI. Automation/occupancy-triggered changes and
  physical-switch presses are excluded (no `context_user_id`).
- appends events to `~/workspace/state/usage_events.jsonl` (HA recorder only
  keeps ~10 days; the ledger lets scoring span months)
- scores each entity with recency-weighted decay (half-life 14 days) so
  controls you stop using fade out and get replaced
- rewrites the top-8 grid on home view 0

Tunables in the script: `TOP_N`, `HALF_LIFE_DAYS`, `LEDGER_KEEP_DAYS`,
`CONTROL_DOMAINS`, `SECTION_TITLE`.

Script: `scripts/ha/frequently_used.py`. Idempotent — finds the existing
"Frequently Used" title card and replaces only the grid after it.

Edit Schedule

Frequency

Result:

Runs (7d)

Completed

Failed

Timeout

100%

Success (7d)

27s

Avg Duration

home-assistant dashboard lighting

Run History (30)

Started	Finished	Status	Duration	Output	Log
9m ago	9m ago	completed	16s	collected 0 new events \| ledger 363 \| ranked 42 entities 28.98 switch.garage 23.77 cover.garage_elmar 23.77 ... collected 0 new events \| ledger 363 \| ranked 42 entities 28.98 switch.garage 23.77 cover.garage_elmar 23.77 switch.sonoff_100113ef54 18.75 light.elmar_lamp 12.48 light.dining_lamp 12.22 light.lounge_lamp 11.23 cover.garage_gym 11.23 switch.sonoff_1001865d8d dashboard save: True	View log
6h ago	6h ago	completed	20s	collected 1 new events \| ledger 363 \| ranked 42 entities 29.34 switch.garage 24.07 cover.garage_elmar 24.07 ... collected 1 new events \| ledger 363 \| ranked 42 entities 29.34 switch.garage 24.07 cover.garage_elmar 24.07 switch.sonoff_100113ef54 18.98 light.elmar_lamp 12.63 light.dining_lamp 12.38 light.lounge_lamp 11.37 cover.garage_gym 11.37 switch.sonoff_1001865d8d dashboard save: True	View log
12h ago	12h ago	completed	31s	collected 4 new events \| ledger 362 \| ranked 42 entities 29.71 switch.garage 24.37 cover.garage_elmar 24.37 ... collected 4 new events \| ledger 362 \| ranked 42 entities 29.71 switch.garage 24.37 cover.garage_elmar 24.37 switch.sonoff_100113ef54 19.22 light.elmar_lamp 12.79 light.dining_lamp 12.53 light.lounge_lamp 11.51 cover.garage_gym 11.51 switch.sonoff_1001865d8d dashboard save: True	View log
18h ago	18h ago	completed	18s	collected 0 new events \| ledger 358 \| ranked 42 entities 30.07 switch.garage 24.67 cover.garage_elmar 24.67 ... collected 0 new events \| ledger 358 \| ranked 42 entities 30.07 switch.garage 24.67 cover.garage_elmar 24.67 switch.sonoff_100113ef54 19.45 light.elmar_lamp 11.94 light.dining_lamp 11.68 light.lounge_lamp 11.65 cover.garage_gym 11.65 switch.sonoff_1001865d8d dashboard save: True	View log
1d ago	1d ago	completed	16s	collected 0 new events \| ledger 358 \| ranked 42 entities 30.45 switch.garage 24.98 cover.garage_elmar 24.98 ... collected 0 new events \| ledger 358 \| ranked 42 entities 30.45 switch.garage 24.98 cover.garage_elmar 24.98 switch.sonoff_100113ef54 19.70 light.elmar_lamp 12.09 light.dining_lamp 11.83 light.lounge_lamp 11.80 cover.garage_gym 11.80 switch.sonoff_1001865d8d dashboard save: True	View log
1d ago	1d ago	completed	28s	collected 1 new events \| ledger 358 \| ranked 42 entities 30.83 switch.garage 25.29 cover.garage_elmar 25.29 ... collected 1 new events \| ledger 358 \| ranked 42 entities 30.83 switch.garage 25.29 cover.garage_elmar 25.29 switch.sonoff_100113ef54 19.94 light.elmar_lamp 12.24 light.dining_lamp 11.97 light.lounge_lamp 11.95 cover.garage_gym 11.95 switch.sonoff_1001865d8d dashboard save: True	View log
2d ago	2d ago	completed	22s	collected 0 new events \| ledger 357 \| ranked 42 entities 31.21 switch.garage 25.61 cover.garage_elmar 25.61 ... collected 0 new events \| ledger 357 \| ranked 42 entities 31.21 switch.garage 25.61 cover.garage_elmar 25.61 switch.sonoff_100113ef54 19.18 light.elmar_lamp 12.40 light.dining_lamp 12.12 light.lounge_lamp 12.10 cover.garage_gym 12.10 switch.sonoff_1001865d8d dashboard save: True	View log
2d ago	2d ago	completed	20s	collected 0 new events \| ledger 357 \| ranked 42 entities 31.60 switch.garage 25.93 cover.garage_elmar 25.93 ... collected 0 new events \| ledger 357 \| ranked 42 entities 31.60 switch.garage 25.93 cover.garage_elmar 25.93 switch.sonoff_100113ef54 19.42 light.elmar_lamp 12.55 light.dining_lamp 12.25 cover.garage_gym 12.25 switch.sonoff_1001865d8d 4.41 light.nicolette_lamp dashboard save: True	View log
2d ago	2d ago	completed	16s	collected 0 new events \| ledger 357 \| ranked 42 entities 32.00 switch.garage 26.25 cover.garage_elmar 26.25 ... collected 0 new events \| ledger 357 \| ranked 42 entities 32.00 switch.garage 26.25 cover.garage_elmar 26.25 switch.sonoff_100113ef54 19.66 light.elmar_lamp 12.71 light.dining_lamp 12.43 light.lounge_lamp 12.40 cover.garage_gym 12.40 switch.sonoff_1001865d8d dashboard save: True	View log
2d ago	2d ago	completed	18s	collected 7 new events \| ledger 357 \| ranked 42 entities 32.39 switch.garage 26.57 cover.garage_elmar 26.57 ... collected 7 new events \| ledger 357 \| ranked 42 entities 32.39 switch.garage 26.57 cover.garage_elmar 26.57 switch.sonoff_100113ef54 19.90 light.elmar_lamp 12.86 light.dining_lamp 12.58 light.lounge_lamp 12.55 cover.garage_gym 12.55 switch.sonoff_1001865d8d dashboard save: True	View log
3d ago	3d ago	completed	22s	collected 11 new events \| ledger 350 \| ranked 42 entities 30.80 switch.garage 26.91 cover.garage_elmar 26.91 ... collected 11 new events \| ledger 350 \| ranked 42 entities 30.80 switch.garage 26.91 cover.garage_elmar 26.91 switch.sonoff_100113ef54 19.15 light.elmar_lamp 13.03 light.dining_lamp 12.74 light.lounge_lamp 10.71 cover.garage_gym 10.71 switch.sonoff_1001865d8d dashboard save: True	View log
3d ago	3d ago	completed	2.8m	Self-healed (attempt 1): collected 0 new events \| ledger 339 \| ranked 42 entities 27.24 cover.garage_elmar 27.24 ... Self-healed (attempt 1): collected 0 new events \| ledger 339 \| ranked 42 entities 27.24 cover.garage_elmar 27.24 switch.sonoff_100113ef54 19.39 light.elmar_lamp 11.17 light.dining_lamp 10.88 light.lounge_lamp 9.83 cover.garage_gym 9.83 switch.sonoff_1001865d8d 4.63 light.nicolette_lamp dashboard save: True	View log
3d ago	3d ago	completed	16s	collected 5 new events \| ledger 337 \| ranked 42 entities 30.55 switch.garage 27.58 cover.garage_elmar 27.58 ... collected 5 new events \| ledger 337 \| ranked 42 entities 30.55 switch.garage 27.58 cover.garage_elmar 27.58 switch.sonoff_100113ef54 18.63 light.elmar_lamp 11.31 light.dining_lamp 11.01 light.lounge_lamp 9.96 cover.garage_gym 9.96 switch.sonoff_1001865d8d dashboard save: True	View log
3d ago	3d ago	completed	19s	collected 0 new events \| ledger 332 \| ranked 42 entities 30.92 switch.garage 27.92 cover.garage_elmar 27.92 ... collected 0 new events \| ledger 332 \| ranked 42 entities 30.92 switch.garage 27.92 cover.garage_elmar 27.92 switch.sonoff_100113ef54 13.80 light.elmar_lamp 11.45 light.dining_lamp 11.15 light.lounge_lamp 10.08 cover.garage_gym 10.08 switch.sonoff_1001865d8d dashboard save: True	View log
4d ago	4d ago	completed	21s	collected 17 new events \| ledger 332 \| ranked 42 entities 31.31 switch.garage 28.27 cover.garage_elmar 28.27 ... collected 17 new events \| ledger 332 \| ranked 42 entities 31.31 switch.garage 28.27 cover.garage_elmar 28.27 switch.sonoff_100113ef54 13.98 light.elmar_lamp 11.59 light.dining_lamp 11.29 light.lounge_lamp 10.20 cover.garage_gym 10.20 switch.sonoff_1001865d8d dashboard save: True	View log
4d ago	4d ago	completed	18s	collected 0 new events \| ledger 315 \| ranked 42 entities 30.69 switch.garage 23.58 cover.garage_elmar 23.58 ... collected 0 new events \| ledger 315 \| ranked 42 entities 30.69 switch.garage 23.58 cover.garage_elmar 23.58 switch.sonoff_100113ef54 14.15 light.elmar_lamp 10.73 light.dining_lamp 10.42 light.lounge_lamp 9.32 cover.garage_gym 9.32 switch.sonoff_1001865d8d dashboard save: True	View log
4d ago	4d ago	completed	16s	collected 0 new events \| ledger 315 \| ranked 42 entities 31.08 switch.garage 23.87 cover.garage_elmar 23.87 ... collected 0 new events \| ledger 315 \| ranked 42 entities 31.08 switch.garage 23.87 cover.garage_elmar 23.87 switch.sonoff_100113ef54 14.33 light.elmar_lamp 10.86 light.dining_lamp 10.55 light.lounge_lamp 9.44 cover.garage_gym 9.44 switch.sonoff_1001865d8d dashboard save: True	View log
4d ago	4d ago	completed	20s	collected 0 new events \| ledger 315 \| ranked 42 entities 31.46 switch.garage 24.17 cover.garage_elmar 24.17 ... collected 0 new events \| ledger 315 \| ranked 42 entities 31.46 switch.garage 24.17 cover.garage_elmar 24.17 switch.sonoff_100113ef54 14.51 light.elmar_lamp 11.00 light.dining_lamp 10.68 light.lounge_lamp 9.56 cover.garage_gym 9.56 switch.sonoff_1001865d8d dashboard save: True	View log
5d ago	5d ago	completed	22s	collected 62 new events \| ledger 315 \| ranked 42 entities 31.85 switch.garage 24.47 cover.garage_elmar 24.47 ... collected 62 new events \| ledger 315 \| ranked 42 entities 31.85 switch.garage 24.47 cover.garage_elmar 24.47 switch.sonoff_100113ef54 14.69 light.elmar_lamp 11.13 light.dining_lamp 10.82 light.lounge_lamp 9.67 cover.garage_gym 9.67 switch.sonoff_1001865d8d dashboard save: True	View log
5d ago	5d ago	completed	18s	collected 0 new events \| ledger 253 \| ranked 42 entities 14.87 light.elmar_lamp 14.15 switch.garage 9.80 co ... collected 0 new events \| ledger 253 \| ranked 42 entities 14.87 light.elmar_lamp 14.15 switch.garage 9.80 cover.garage_gym 9.80 switch.sonoff_1001865d8d 9.26 light.dining_lamp 8.93 light.lounge_lamp 6.67 cover.garage_elmar 6.67 switch.sonoff_100113ef54 dashboard save: True	View log
5d ago	5d ago	completed	15s	collected 0 new events \| ledger 253 \| ranked 42 entities 15.05 light.elmar_lamp 14.32 switch.garage 9.92 co ... collected 0 new events \| ledger 253 \| ranked 42 entities 15.05 light.elmar_lamp 14.32 switch.garage 9.92 cover.garage_gym 9.92 switch.sonoff_1001865d8d 9.37 light.dining_lamp 9.04 light.lounge_lamp 6.75 cover.garage_elmar 6.75 switch.sonoff_100113ef54 dashboard save: True	View log
5d ago	5d ago	completed	20s	collected 0 new events \| ledger 253 \| ranked 42 entities 15.24 light.elmar_lamp 14.50 switch.garage 10.04 co ... collected 0 new events \| ledger 253 \| ranked 42 entities 15.24 light.elmar_lamp 14.50 switch.garage 10.04 cover.garage_gym 10.04 switch.sonoff_1001865d8d 9.49 light.dining_lamp 9.16 light.lounge_lamp 6.84 cover.garage_elmar 6.84 switch.sonoff_100113ef54 dashboard save: True	View log
6d ago	6d ago	completed	1.3m	collected 1 new events \| ledger 253 \| ranked 42 entities 15.43 light.elmar_lamp 14.68 switch.garage 10.17 co ... collected 1 new events \| ledger 253 \| ranked 42 entities 15.43 light.elmar_lamp 14.68 switch.garage 10.17 cover.garage_gym 10.17 switch.sonoff_1001865d8d 9.61 light.dining_lamp 9.27 light.lounge_lamp 6.92 cover.garage_elmar 6.92 switch.sonoff_100113ef54 dashboard save: True	View log
6d ago	6d ago	completed	18s	collected 0 new events \| ledger 252 \| ranked 42 entities 15.62 light.elmar_lamp 14.87 switch.garage 10.29 co ... collected 0 new events \| ledger 252 \| ranked 42 entities 15.62 light.elmar_lamp 14.87 switch.garage 10.29 cover.garage_gym 10.29 switch.sonoff_1001865d8d 9.73 light.dining_lamp 9.39 light.lounge_lamp 7.01 cover.garage_elmar 7.01 switch.sonoff_100113ef54 dashboard save: True	View log
6d ago	6d ago	completed	16s	collected 0 new events \| ledger 252 \| ranked 42 entities 15.82 light.elmar_lamp 15.05 switch.garage 10.42 co ... collected 0 new events \| ledger 252 \| ranked 42 entities 15.82 light.elmar_lamp 15.05 switch.garage 10.42 cover.garage_gym 10.42 switch.sonoff_1001865d8d 9.85 light.dining_lamp 9.50 light.lounge_lamp 7.10 cover.garage_elmar 7.10 switch.sonoff_100113ef54 dashboard save: True	View log
6d ago	6d ago	completed	20s	collected 1 new events \| ledger 252 \| ranked 42 entities 16.02 light.elmar_lamp 15.24 switch.garage 10.55 co ... collected 1 new events \| ledger 252 \| ranked 42 entities 16.02 light.elmar_lamp 15.24 switch.garage 10.55 cover.garage_gym 10.55 switch.sonoff_1001865d8d 9.97 light.dining_lamp 9.62 light.lounge_lamp 7.18 cover.garage_elmar 7.18 switch.sonoff_100113ef54 dashboard save: True	View log
7d ago	7d ago	completed	29s	collected 2 new events \| ledger 251 \| ranked 42 entities 15.43 switch.garage 15.21 light.elmar_lamp 10.68 co ... collected 2 new events \| ledger 251 \| ranked 42 entities 15.43 switch.garage 15.21 light.elmar_lamp 10.68 cover.garage_gym 10.68 switch.sonoff_1001865d8d 10.09 light.dining_lamp 9.74 light.lounge_lamp 7.27 cover.garage_elmar 7.27 switch.sonoff_100113ef54 dashboard save: True	View log
7d ago	7d ago	completed	19s	collected 3 new events \| ledger 249 \| ranked 42 entities 15.62 switch.garage 15.40 light.elmar_lamp 10.81 co ... collected 3 new events \| ledger 249 \| ranked 42 entities 15.62 switch.garage 15.40 light.elmar_lamp 10.81 cover.garage_gym 10.81 switch.sonoff_1001865d8d 9.86 light.lounge_lamp 9.21 light.dining_lamp 7.36 cover.garage_elmar 7.36 switch.sonoff_100113ef54 dashboard save: True	View log
7d ago	7d ago	completed	16s	collected 0 new events \| ledger 246 \| ranked 42 entities 15.82 switch.garage 14.59 light.elmar_lamp 10.95 co ... collected 0 new events \| ledger 246 \| ranked 42 entities 15.82 switch.garage 14.59 light.elmar_lamp 10.95 cover.garage_gym 10.95 switch.sonoff_1001865d8d 9.99 light.lounge_lamp 9.32 light.dining_lamp 7.46 cover.garage_elmar 7.46 switch.sonoff_100113ef54 dashboard save: True	View log
7d ago	7d ago	completed	21s	collected 0 new events \| ledger 246 \| ranked 42 entities 16.01 switch.garage 14.77 light.elmar_lamp 11.09 co ... collected 0 new events \| ledger 246 \| ranked 42 entities 16.01 switch.garage 14.77 light.elmar_lamp 11.09 cover.garage_gym 11.09 switch.sonoff_1001865d8d 10.11 light.lounge_lamp 9.44 light.dining_lamp 7.55 cover.garage_elmar 7.55 switch.sonoff_100113ef54 dashboard save: True	View log

Comments (0)

No comments yet — add instructions for Luci

←