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
Decision gist · record as of 2026-07-17
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.
Use it when
- serve-sim-placeholder-assets includes tooling to fix broken iPhone, iPad, Watch, or Vision simulator preview placeholders.
- Yes.
Verify before relying
Read SKILL.md below before installing (3 files). Open directory: indexed for reading, not audited.
Install
EvanBacon/serve-sim/serve-sim-placeholder-assets · repository language: TypeScript
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently 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.
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
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Audit and update device placeholder preview images after Xcode or macOS installation”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
serve-sim exposes your Apple Simulator as a controllable web interface, making it accessible to AI coding agents and automation tools. Stream the simulator's display as MJPEG and send interactions back via WebSocket—perfect for local development, LAN sharing, or remote Mac setups with tunneling.
This skill enables developers to launch and validate iOS applications within a simulated environment, eliminating the need for physical hardware during early-stage testing. Streamline your debugging workflow by catching issues before deployment to real devices.
Automate iOS simulator device management directly within Claude conversations. This skill provides streamlined control over simulator lifecycle operations—launching, provisioning, and removing devices—without leaving your development environment. Designed for developers who want to integrate simulator management into their AI-assisted workflows.
ce-test-xcode streamlines iOS development by automating simulator-based testing, screenshot generation, and log aggregation in a single workflow. Built for engineers who need faster iteration cycles, this skill reduces manual testing overhead and captures the artifacts you need for debugging and validation.
This skill enables developers to launch and evaluate iOS applications within a simulated runtime environment. Test app interactions, workflows, and UI responsiveness directly from your development setup, eliminating the need for hardware during early-stage validation cycles.
simulator-utils streamlines iOS development by automating screenshot capture and resizing within the simulator environment. Perfect for testing UI consistency across different device configurations and verifying API compatibility without manual image processing. Works seamlessly with Claude Code and other coding agents to accelerate your iOS workflow.