ios-sync

Regenerate the iOS debug bridge and typed state accessors from upstream gstack templates.

Updated Aug 9, 2026
One-click install
npx skills add https://github.com/raghavbadhwar/rstack --skill ios-sync-raghavbadhwar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ios-sync
Source: https://github.com/raghavbadhwar/rstack/tree/main/ios-sync
Command: npx skills add https://github.com/raghavbadhwar/rstack --skill ios-sync-raghavbadhwar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After upgrading gstack or adding new ViewModels and properties to an iOS project, the debug bridge files (StateServer.swift, DebugOverlay.swift, Package.swift) and typed @Observable state accessors drift out of sync with the latest upstream templates, breaking instrumentation coverage. ## Core Features & Use Cases - Bridge regeneration: Updates StateServer.swift, DebugOverlay.swift, and Package.swift against the latest upstream gstack templates. - Accessor regeneration: Rebuilds typed @Observable state accessors so new ViewModels and properties get debug coverage. - Use Case: After bumping gstack to a new version, run this skill to resync the iOS debug bridge so the QA and debugging instrumentation keeps working against the updated templates. ## Quick Start Ask the agent to resync the iOS debug bridge and regenerate the iOS accessors after upgrading gstack.

Frequently Asked Questions about ios-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I resync the iOS debug bridge after upgrading gstack?

Invoke the ios-sync skill, which regenerates StateServer.swift, DebugOverlay.swift, Package.swift, and the typed @Observable state accessors against the latest upstream gstack templates. Trigger it with phrases like "resync the iOS debug bridge".

When should I regenerate iOS accessors in a gstack project?

Regenerate accessors after upgrading gstack or after adding new ViewModels and properties that need debug coverage. The skill rebuilds the typed @Observable state accessors so the new state is visible to the debug bridge.

What files does the iOS debug bridge sync update?

It updates StateServer.swift, DebugOverlay.swift, Package.swift, and the typed @Observable state accessors. These files together form the gstack iOS instrumentation layer.

Does ios-sync work in headless or spawned agent sessions?

Yes. The preamble detects session kind and adjusts behavior: spawned sessions auto-choose recommended options without interactive prompts, while headless sessions block on unavailable AskUserQuestion calls instead of prompting.

Why is my iOS debug instrumentation out of date after a gstack upgrade?

The debug bridge files are generated from upstream gstack templates, so a gstack upgrade can change those templates without touching your project. Running ios-sync regenerates the bridge and accessors against the new templates.