serve-sim-placeholder-assets
serve-sim-placeholder-assets lets you broadcast Apple Simulator screens to AI coding agents like Codex, whether running on your local machine, across your network, or tunneled from a remote Mac. The skill wraps a lightweight Swift helper that taps into the simulator's framebuffer through simctl, then serves it as an MJPEG stream with WebSocket-based device controls—enabling agents to see and interact with your simulator environment in real time.
serve-sim-placeholder-assets provides an audit and update workflow to refresh your device placeholder preview images whenever you install a new Xcode or macOS version. Run the asset audit script to map placeholder images to device types and sync them with CoreTypes resources from your Xcode installation. This ensures iPhone, iPad, Watch, and Vision simulator preview placeholders stay current and render correctly in your Device Hub-style interface.
AI-generated summary based on this skill's SKILL.md
Install
EvanBacon/serve-sim/serve-sim-placeholder-assets · repository language: TypeScript
git clone https://github.com/EvanBacon/serve-sim
cp -r serve-sim/.codex/skills/serve-sim-placeholder-assets ~/.claude/skills/serve-sim-placeholder-assetsFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I update serve-sim placeholder assets after Xcode installation?
serve-sim-placeholder-assets provides an audit and update workflow to refresh your device placeholder preview images whenever you install a new Xcode or macOS version. Run the asset audit script to map placeholder images to device types and sync them with CoreTypes resources from your Xcode installation. This ensures iPhone, iPad, Watch, and Vision simulator preview placeholders stay current and render correctly in your Device Hub-style interface.
What should I do if simulator preview placeholders are broken?
serve-sim-placeholder-assets includes tooling to fix broken iPhone, iPad, Watch, or Vision simulator preview placeholders. The asset audit script scans your placeholder assets repository, identifies mismatched or missing device images, and resyncs them against the CoreTypes resources bundled with your Xcode installation. This restores accurate device preview rendering across all simulator types.
Can I audit device hub simulator images with serve-sim?
Yes. serve-sim-placeholder-assets maintains a Device Hub-style placeholder asset system with built-in audit capabilities. Run the asset audit script to map all placeholder images to their corresponding device types, verify references against CoreTypes resources, and generate a report of any misalignments. This internal asset maintenance workflow keeps your simulator preview images synchronized and valid.
How does the serve-sim device placeholder assets script work?
serve-sim-placeholder-assets includes a Node-based asset audit script that scans your placeholder assets codex, cross-references device types with CoreTypes resources, and updates preview images as needed. The script automates the mapping between simulator device placeholders and their visual representations, ensuring consistency after Xcode or macOS updates without manual intervention.
What license covers serve-sim-placeholder-assets?
serve-sim-placeholder-assets is distributed under the Apache-2.0 license, allowing you to use, modify, and distribute the skill freely within the terms of that open-source license.
SKILL.md
rendered from the published skill — quoted content, verbatim
serve-sim Placeholder Assets
Use this project-scoped skill when updating the not-running device preview images in this repo.
Workflow
- Read references/device-placeholder-assets.md.
- Run the audit script from the repo root:
sh
node .codex/skills/serve-sim-placeholder-assets/scripts/audit-placeholder-assets.mjs --out tmp/device-placeholder-assets
- Keep the public
skills/serve-simskill focused on end-user CLI usage; do not add this internal asset-maintenance workflow there. - Update app code/tests only after reviewing the audit output for exact, fallback, or missing mappings.
Read as markdown · JSON record · Browse the source repository
File tree — 3 files
.codex/skills/serve-sim-placeholder-assets/SKILL.md
.codex/skills/serve-sim-placeholder-assets/references/device-placeholder-assets.md
.codex/skills/serve-sim-placeholder-assets/scripts/audit-placeholder-assets.mjs