# Ha IOS Magicitem

> The cross-platform MagicItem action model shared by Widgets, Watch, CarPlay, and App Shortcuts. Use when adding or changing item types or action overrides, or touching anything that persists MagicItem via Codable.

- Skill: `home-assistant/ha-ios-magicitem` (Agent Skill)
- Install (CLI): `npx skillmds@latest add home-assistant/ha-ios-magicitem`
- Raw SKILL.md: https://api.skillmd.com/api/skills/home-assistant/ha-ios-magicitem/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: home-assistant (https://skillmd.com/u/home-assistant)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/home-assistant/ha-ios-magicitem

---


# MagicItem — Cross-Platform Action Abstraction

`MagicItem` (`Sources/Shared/MagicItem/MagicItem.swift`) is the shared model for items that can appear in Widgets, Watch, CarPlay, and App Shortcuts. It has a `type` (`.script`, `.scene`, `.entity`, `.action`, `.folder`, `.assistPipeline`) and an optional `action` override. `ItemType.rawValue` is persisted (Codable), so **never change existing raw values**.