ios-sync

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

1|Updated Jul 23, 2026
One-click install
npx skills add https://github.com/sanjanb/my-agent-harness --skill ios-sync-sanjanb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ios-sync
Source: https://github.com/sanjanb/my-agent-harness/tree/main/skills/gstack-ios-sync
Command: npx skills add https://github.com/sanjanb/my-agent-harness --skill ios-sync-sanjanb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After upgrading gstack or adding new ViewModels and properties, the iOS debug bridge files drift out of sync with the upstream templates, leaving StateServer.swift, DebugOverlay.swift, Package.swift, and the @Observable state accessors stale or incomplete. ## Core Features & Use Cases - Template Regeneration: Rebuilds StateServer.swift, DebugOverlay.swift, and Package.swift against the latest upstream gstack templates. - Accessor Coverage: Generates typed @Observable state accessors so new ViewModels and properties are exposed to the debug bridge. - Use Case: After bumping gstack to a new version, run the sync so the iOS app's debug overlay and state server reflect the new instrumentation surface without hand-editing Swift files. ## Quick Start Ask the agent to resync the iOS debug bridge after upgrading gstack or adding new ViewModels that need accessor coverage.

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, and Package.swift from the latest upstream gstack templates. It also rebuilds the typed @Observable state accessors so the bridge matches the new version.

When should I regenerate iOS accessors for gstack?

Regenerate accessors whenever you upgrade gstack or add new ViewModels and properties that need debug bridge coverage. Without regeneration, new state will not be visible through the debug overlay or state server.

Which files does the gstack iOS sync update?

The sync updates StateServer.swift, DebugOverlay.swift, Package.swift, and the typed @Observable state accessors. All are regenerated from upstream gstack templates rather than edited by hand.

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

Yes, the skill's preamble detects headless and spawned sessions and adjusts behavior accordingly. In spawned sessions it skips interactive prompts and auto-chooses recommended options, while headless runs block on unavailable user questions.

What happens if gstack templates are out of date during a sync?

The preamble runs an update check and surfaces UPGRADE_AVAILABLE output when a newer gstack exists. In that case the skill directs you through the inline upgrade flow before continuing the sync.