Skip to content
Get packs

Xcode Fleet Sync

Syncs exact Xcode builds across a fleet of Macs with signature checks, install rules and smoke tests

Source Download skill
Repository
steipete/agent-scripts
Stars
7,433
Licence
MIT
Files
6 files

What it does

This skill teaches an AI agent a careful, multi-step routine for installing the same Xcode build on several Macs. The agent inventories which machines are reachable, verifies each downloaded Xcode archive's Apple signature and build number, transfers and installs it into fixed /Applications slots, and runs a quick command-line check before discarding the old copy. It also audits and cleans up unused iOS simulator runtimes, but only using Apple's own outdated/unusable classifications, and it blocks repairs while a simulator is booted.

Great for

  • Mac developers or small teams who maintain several Macs and need matching Xcode versions on each
  • Maintainers of a personal or team Mac fleet who want repeatable, rollback-safe Xcode installs

Skip it if

  • Single-Mac users who just want to install Xcode from the App Store; the routine is heavy and assumes SSH, Tailscale and a fleet layout
  • Environments where agents must not run shell commands or touch /Applications, since the procedure runs scripts, deletes apps and may use sudo

Try asking

  • “Sync Xcode 26.6 from my downloaded .xip to all my Macs, skipping any that are on macOS 27”
  • “Audit the simulator runtimes on my fleet with the hygiene script and report drift without repairing”
  • “Check which of my Macs have which Xcode builds selected and list any unreachable hosts”
Step-by-step guide: how to use Xcode Fleet SyncInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 6 original files, the MIT licence and an attribution note.

    xcode-sync.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip xcode-sync.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip xcode-sync.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Run the inventory and simulator audit first in read-only mode and review the output before asking for any install or --repair action.
  • Confirm the host identity and that no Xcode work is in progress before allowing repairs or replacements, as the skill itself requires.
  • Keep the rollback copies until the smoke gate passes; the skill is designed to retain them on failure.

What's inside

  • agents/openai.yaml
  • scripts/xcode-host-inventory.sh
  • scripts/xcode-post-install-smoke.sh
  • scripts/xcode-post-install-smoke.test.sh
  • scripts/xcode-simulator-hygiene.sh
  • SKILL.md

Redistributed unmodified from steipete/agent-scripts under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.