Codex Home Assistant iOS Persistence for New GRDB Models

Follow Home Assistant iOS guidance for choosing GRDB for new structured models or UserDefaults for simple preferences.

Install in Codex

Open Home Assistant iOS in Codex with its Swift storage setup and the proposed data shape.

Review `.agents/skills/ha-ios-persistence/SKILL.md` and its requirements at the pinned GitHub commit.
Create `.agents/skills/ha-ios-persistence/` in your project and save the reviewed file as `.agents/skills/ha-ios-persistence/SKILL.md`.
Start Codex from that project's root, then type `$ha-ios-persistence` and select the matching skill.

Example task

Choose storage for these illustrative panel records.
{"feature":"panel shortcut","recordFields":["label","order"],"newModel":true,"simplePreference":false}

What to check

Choose `GRDB` for the new records, outline `DatabaseTableProtocol`, and register the table. The fields are `label` and `order`.

Original SKILL.md on GitHub · Updated 2026-11-14

Frequently asked question

What if I only store an ordinary display preference?

The project keeps simple preferences in UserDefaults. Existing Realm models stay with their current layer.