ios-sync

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

Updated Jun 22, 2026
One-click install
npx skills add https://github.com/aicodepro/ai-agent-nexi --skill ios-sync-aicodepro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ios-sync
Source: https://github.com/aicodepro/ai-agent-nexi/tree/main/agent/skills/gstack/ios-sync
Command: npx skills add https://github.com/aicodepro/ai-agent-nexi --skill ios-sync-aicodepro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When gstack is upgraded or new ViewModels and properties are added to an iOS project, the debug bridge files (StateServer.swift, DebugOverlay.swift, Package.swift) and the typed @Observable state accessors drift out of sync with the upstream templates, breaking the iOS instrumentation. This Skill regenerates those files so the debug bridge matches the latest gstack templates. ## Core Features & Use Cases - Template Regeneration: Updates StateServer.swift, DebugOverlay.swift, and Package.swift against the latest upstream gstack templates. - Accessor Coverage: Regenerates typed @Observable state accessors so new ViewModels and properties are exposed to the debug bridge. - Environment Preamble: Runs a standardized gstack preamble that checks for upgrades, telemetry and proactive-skill configuration, session kind, and artifact sync state before executing. - Use Case: After upgrading gstack or adding a new ViewModel to your iOS app, ask to resync the iOS debug bridge so the debug overlay and state server reflect the new properties. ## Quick Start Ask the assistant to resync the iOS debug bridge and regenerate the gstack iOS accessors after upgrading gstack or adding new ViewModels.

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 from the latest upstream gstack templates. Run it whenever you upgrade gstack or add new ViewModels.

When should I regenerate iOS accessors in a gstack project?

Regenerate accessors after upgrading gstack or after adding new ViewModels or properties that need accessor coverage. This keeps the debug overlay and state server in sync with your app's observable state.

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 iOS debug instrumentation generated from gstack templates.

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

Yes. The preamble detects the session kind, and in spawned or headless sessions it skips interactive prompts such as upgrade checks, telemetry, and routing questions, auto-choosing recommended options and reporting results as prose.

Why does the skill run a long preamble before syncing?

The preamble checks for gstack upgrades, telemetry and proactive-skill configuration, session type, vendored installations, and artifact sync state. These checks gate one-time setup prompts and ensure the skill behaves correctly across interactive, headless, and Conductor-hosted sessions.