[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-expo-install-xcode":3,"mdc-pfx7mx-key":35,"related-repo-expo-install-xcode":946,"related-org-expo-install-xcode":971},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":25,"repoUrl":26,"updatedAt":27,"license":28,"forks":25,"topics":29,"repo":30,"sourceUrl":33,"mdContent":34},"install-xcode","install Xcode versions on macOS","Install a specific Xcode version on a Mac using the xcodes CLI, handing the Apple ID sign-in (password + 2FA) to the user through a shared live terminal. Use when a task needs Xcode\u002Fsimulators and the machine doesn't have the right version, or the user asks to install\u002Fupgrade Xcode.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"expo","Expo","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fexpo.png",[12,16,19,22],{"name":13,"slug":14,"type":15},"macOS","macos","tag",{"name":17,"slug":18,"type":15},"Mobile","mobile",{"name":20,"slug":21,"type":15},"Deployment","deployment",{"name":23,"slug":24,"type":15},"Xcode","xcode",0,"https:\u002F\u002Fgithub.com\u002Fexpo\u002Ftuft-skills","2026-07-27T06:06:03.255819",null,[],{"repoUrl":26,"stars":25,"forks":25,"topics":31,"description":32},[],"A collection of useful skills for Tuft agents.","https:\u002F\u002Fgithub.com\u002Fexpo\u002Ftuft-skills\u002Ftree\u002FHEAD\u002Finstall-xcode","---\nname: install-xcode\ndescription: Install a specific Xcode version on a Mac using the xcodes CLI, handing the Apple ID sign-in (password + 2FA) to the user through a shared live terminal. Use when a task needs Xcode\u002Fsimulators and the machine doesn't have the right version, or the user asks to install\u002Fupgrade Xcode.\n---\n\n# Install Xcode\n\nInstall Xcode non-interactively where possible, and hand exactly one step — the Apple ID sign-in — to the user via a shared terminal. Never ask the user to paste Apple credentials into chat.\n\n## 0. Check the platform\n\nXcode only runs on macOS. Check `uname -s` first — if it prints `Linux`, stop: this machine cannot install Xcode. Tell the user they need to use EAS (Expo Application Services) to build for iOS from this machine instead.\n\n## 1. Check what's needed\n\n- Already installed? `ls \u002FApplications | grep -i xcode` and `xcodebuild -version`. If the right version is present, stop.\n- **Pick the version the work actually needs, not the newest.** For repo work, match CI: look for `.xcode-version`, or `grep -rn 'Xcode_\\|xcode-select --switch' .github\u002Fworkflows\u002F` in the target repo (e.g. expo\u002Fexpo pins the version in `ios-unit-tests.yml`). Fall back to latest release.\n- Disk: Xcode needs ~20 GB installed plus ~8 GB for a simulator runtime, and unxip needs headroom. Check `df -h \u002F` and don't start below ~50 GB free.\n\n## 2. Get the xcodes CLI\n\nPrefer the prebuilt binary — `brew install xcodesorg\u002Fmade\u002Fxcodes` builds from source and fails on machines with stale Command Line Tools (error: `xcbuild ... does not exist`), which is likely on a box that doesn't have Xcode yet:\n\n```sh\ncurl -sL -o \u002Ftmp\u002Fxcodes.zip https:\u002F\u002Fgithub.com\u002FXcodesOrg\u002Fxcodes\u002Freleases\u002Flatest\u002Fdownload\u002Fxcodes.zip\ncd \u002Ftmp && unzip -o -q xcodes.zip && chmod +x xcodes\nmkdir -p \u002Ftmp\u002Fcbin && mv \u002Ftmp\u002Fxcodes \u002Ftmp\u002Fcbin\u002Fxcodes   # or \u002Fusr\u002Flocal\u002Fbin if sudo works\n```\n\n`brew install aria2` (optional) makes downloads much faster; xcodes uses it automatically when present.\n\nVerify: `\u002Ftmp\u002Fcbin\u002Fxcodes version` and `\u002Ftmp\u002Fcbin\u002Fxcodes list | tail` (the list works unauthenticated; confirm your target version appears).\n\n## 3. Try unattended first\n\nIf this machine has installed Xcode via xcodes before, the Apple ID session is already in the keychain and no sign-in is needed:\n\n```sh\nexport PATH=\"\u002Ftmp\u002Fcbin:\u002Fopt\u002Fhomebrew\u002Fbin:$PATH\"\nxcodes install \u003CVERSION> --directory \u002FApplications --experimental-unxip \u003C \u002Fdev\u002Fnull\n```\n\nIf it completes, skip to step 6. If it prints `Apple ID: Missing username or a password`, continue.\n\n## 4. Hand sign-in to the user via a shared terminal\n\nApple requires an Apple ID for every Xcode download; app-specific passwords do **not** work (xcodes needs a real session with 2FA). Don't collect credentials in chat — share a terminal:\n\n1. Call the `share_terminal` tool. It returns a browser URL and a tmux socket\u002Fsession for prepping.\n2. Pre-type (don't run) the install command so the user only presses Enter and answers prompts:\n   ```sh\n   tmux -S '\u003CSOCKET>' send-keys -t '\u003CSESSION>' 'clear; export PATH=\"\u002Ftmp\u002Fcbin:\u002Fopt\u002Fhomebrew\u002Fbin:$PATH\"; echo \"Press Enter, then sign in with your Apple ID (2FA appears here)\"' Enter\n   tmux -S '\u003CSOCKET>' send-keys -t '\u003CSESSION>' 'xcodes install \u003CVERSION> --directory \u002FApplications --experimental-unxip'\n   ```\n3. Send the user the URL with instructions: press Enter, sign in, answer the 2FA prompt in the terminal. Mention that credentials stay between them and the prompt, the session persists in the machine keychain (future installs are unattended), and the link should be treated as sensitive.\n\n## 5. Monitor without nagging\n\nPoll the terminal, not the user: `tmux -S '\u003CSOCKET>' capture-pane -t '\u003CSESSION>' -p | tail`. The phases are: sign-in → `Downloading Xcode \u003CVERSION>` (long; ~3 GB) → `Unarchiving Xcode (This can take a while)` → `xcodes requires superuser privileges` (see below) → done. Check every few minutes (scheduled wakeups, not tight loops). If the pane shows an auth error, tell the user and have them retry in the same terminal.\n\n**Sudo:** near the end xcodes asks for the *macOS account* password (enable dev mode, license). If you have passwordless sudo you can pre-empt this; otherwise the user types the machine password in the same terminal — tell them which password it wants, it's a common point of confusion after just typing an Apple ID password.\n\n## 6. Post-install\n\n```sh\nsudo xcode-select --switch \u002FApplications\u002FXcode-\u003CVERSION>.app\nsudo xcodebuild -license accept\nxcodebuild -runFirstLaunch\nxcodebuild -downloadPlatform iOS        # simulator runtime, ~8 GB — only if iOS sim work is needed\nxcodebuild -version                     # verify\nxcrun simctl list devices | head        # verify simulators exist\n```\n\n## 7. Clean up\n\n- Ask the user to confirm they're done in the terminal, then rotate\u002Fkill the shared terminal link.\n- Delete `\u002Ftmp\u002Fxcodes.zip`. Keep the xcodes binary for future installs.\n- Report the installed version and remaining disk space.\n",{"data":36,"body":37},{"name":4,"description":6},{"type":38,"children":39},"root",[40,48,54,61,83,89,163,169,190,337,348,368,374,379,483,496,502,514,674,680,717,735,741,908,914,940],{"type":41,"tag":42,"props":43,"children":44},"element","h1",{"id":4},[45],{"type":46,"value":47},"text","Install Xcode",{"type":41,"tag":49,"props":50,"children":51},"p",{},[52],{"type":46,"value":53},"Install Xcode non-interactively where possible, and hand exactly one step — the Apple ID sign-in — to the user via a shared terminal. Never ask the user to paste Apple credentials into chat.",{"type":41,"tag":55,"props":56,"children":58},"h2",{"id":57},"_0-check-the-platform",[59],{"type":46,"value":60},"0. Check the platform",{"type":41,"tag":49,"props":62,"children":63},{},[64,66,73,75,81],{"type":46,"value":65},"Xcode only runs on macOS. Check ",{"type":41,"tag":67,"props":68,"children":70},"code",{"className":69},[],[71],{"type":46,"value":72},"uname -s",{"type":46,"value":74}," first — if it prints ",{"type":41,"tag":67,"props":76,"children":78},{"className":77},[],[79],{"type":46,"value":80},"Linux",{"type":46,"value":82},", stop: this machine cannot install Xcode. Tell the user they need to use EAS (Expo Application Services) to build for iOS from this machine instead.",{"type":41,"tag":55,"props":84,"children":86},{"id":85},"_1-check-whats-needed",[87],{"type":46,"value":88},"1. Check what's needed",{"type":41,"tag":90,"props":91,"children":92},"ul",{},[93,115,150],{"type":41,"tag":94,"props":95,"children":96},"li",{},[97,99,105,107,113],{"type":46,"value":98},"Already installed? ",{"type":41,"tag":67,"props":100,"children":102},{"className":101},[],[103],{"type":46,"value":104},"ls \u002FApplications | grep -i xcode",{"type":46,"value":106}," and ",{"type":41,"tag":67,"props":108,"children":110},{"className":109},[],[111],{"type":46,"value":112},"xcodebuild -version",{"type":46,"value":114},". If the right version is present, stop.",{"type":41,"tag":94,"props":116,"children":117},{},[118,124,126,132,134,140,142,148],{"type":41,"tag":119,"props":120,"children":121},"strong",{},[122],{"type":46,"value":123},"Pick the version the work actually needs, not the newest.",{"type":46,"value":125}," For repo work, match CI: look for ",{"type":41,"tag":67,"props":127,"children":129},{"className":128},[],[130],{"type":46,"value":131},".xcode-version",{"type":46,"value":133},", or ",{"type":41,"tag":67,"props":135,"children":137},{"className":136},[],[138],{"type":46,"value":139},"grep -rn 'Xcode_\\|xcode-select --switch' .github\u002Fworkflows\u002F",{"type":46,"value":141}," in the target repo (e.g. expo\u002Fexpo pins the version in ",{"type":41,"tag":67,"props":143,"children":145},{"className":144},[],[146],{"type":46,"value":147},"ios-unit-tests.yml",{"type":46,"value":149},"). Fall back to latest release.",{"type":41,"tag":94,"props":151,"children":152},{},[153,155,161],{"type":46,"value":154},"Disk: Xcode needs ~20 GB installed plus ~8 GB for a simulator runtime, and unxip needs headroom. Check ",{"type":41,"tag":67,"props":156,"children":158},{"className":157},[],[159],{"type":46,"value":160},"df -h \u002F",{"type":46,"value":162}," and don't start below ~50 GB free.",{"type":41,"tag":55,"props":164,"children":166},{"id":165},"_2-get-the-xcodes-cli",[167],{"type":46,"value":168},"2. Get the xcodes CLI",{"type":41,"tag":49,"props":170,"children":171},{},[172,174,180,182,188],{"type":46,"value":173},"Prefer the prebuilt binary — ",{"type":41,"tag":67,"props":175,"children":177},{"className":176},[],[178],{"type":46,"value":179},"brew install xcodesorg\u002Fmade\u002Fxcodes",{"type":46,"value":181}," builds from source and fails on machines with stale Command Line Tools (error: ",{"type":41,"tag":67,"props":183,"children":185},{"className":184},[],[186],{"type":46,"value":187},"xcbuild ... does not exist",{"type":46,"value":189},"), which is likely on a box that doesn't have Xcode yet:",{"type":41,"tag":191,"props":192,"children":197},"pre",{"className":193,"code":194,"language":195,"meta":196,"style":196},"language-sh shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl -sL -o \u002Ftmp\u002Fxcodes.zip https:\u002F\u002Fgithub.com\u002FXcodesOrg\u002Fxcodes\u002Freleases\u002Flatest\u002Fdownload\u002Fxcodes.zip\ncd \u002Ftmp && unzip -o -q xcodes.zip && chmod +x xcodes\nmkdir -p \u002Ftmp\u002Fcbin && mv \u002Ftmp\u002Fxcodes \u002Ftmp\u002Fcbin\u002Fxcodes   # or \u002Fusr\u002Flocal\u002Fbin if sudo works\n","sh","",[198],{"type":41,"tag":67,"props":199,"children":200},{"__ignoreMap":196},[201,234,293],{"type":41,"tag":202,"props":203,"children":206},"span",{"class":204,"line":205},"line",1,[207,213,219,224,229],{"type":41,"tag":202,"props":208,"children":210},{"style":209},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[211],{"type":46,"value":212},"curl",{"type":41,"tag":202,"props":214,"children":216},{"style":215},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[217],{"type":46,"value":218}," -sL",{"type":41,"tag":202,"props":220,"children":221},{"style":215},[222],{"type":46,"value":223}," -o",{"type":41,"tag":202,"props":225,"children":226},{"style":215},[227],{"type":46,"value":228}," \u002Ftmp\u002Fxcodes.zip",{"type":41,"tag":202,"props":230,"children":231},{"style":215},[232],{"type":46,"value":233}," https:\u002F\u002Fgithub.com\u002FXcodesOrg\u002Fxcodes\u002Freleases\u002Flatest\u002Fdownload\u002Fxcodes.zip\n",{"type":41,"tag":202,"props":235,"children":237},{"class":204,"line":236},2,[238,244,249,255,260,264,269,274,278,283,288],{"type":41,"tag":202,"props":239,"children":241},{"style":240},"--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF",[242],{"type":46,"value":243},"cd",{"type":41,"tag":202,"props":245,"children":246},{"style":215},[247],{"type":46,"value":248}," \u002Ftmp",{"type":41,"tag":202,"props":250,"children":252},{"style":251},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[253],{"type":46,"value":254}," &&",{"type":41,"tag":202,"props":256,"children":257},{"style":209},[258],{"type":46,"value":259}," unzip",{"type":41,"tag":202,"props":261,"children":262},{"style":215},[263],{"type":46,"value":223},{"type":41,"tag":202,"props":265,"children":266},{"style":215},[267],{"type":46,"value":268}," -q",{"type":41,"tag":202,"props":270,"children":271},{"style":215},[272],{"type":46,"value":273}," xcodes.zip",{"type":41,"tag":202,"props":275,"children":276},{"style":251},[277],{"type":46,"value":254},{"type":41,"tag":202,"props":279,"children":280},{"style":209},[281],{"type":46,"value":282}," chmod",{"type":41,"tag":202,"props":284,"children":285},{"style":215},[286],{"type":46,"value":287}," +x",{"type":41,"tag":202,"props":289,"children":290},{"style":215},[291],{"type":46,"value":292}," xcodes\n",{"type":41,"tag":202,"props":294,"children":296},{"class":204,"line":295},3,[297,302,307,312,316,321,326,331],{"type":41,"tag":202,"props":298,"children":299},{"style":209},[300],{"type":46,"value":301},"mkdir",{"type":41,"tag":202,"props":303,"children":304},{"style":215},[305],{"type":46,"value":306}," -p",{"type":41,"tag":202,"props":308,"children":309},{"style":215},[310],{"type":46,"value":311}," \u002Ftmp\u002Fcbin",{"type":41,"tag":202,"props":313,"children":314},{"style":251},[315],{"type":46,"value":254},{"type":41,"tag":202,"props":317,"children":318},{"style":209},[319],{"type":46,"value":320}," mv",{"type":41,"tag":202,"props":322,"children":323},{"style":215},[324],{"type":46,"value":325}," \u002Ftmp\u002Fxcodes",{"type":41,"tag":202,"props":327,"children":328},{"style":215},[329],{"type":46,"value":330}," \u002Ftmp\u002Fcbin\u002Fxcodes",{"type":41,"tag":202,"props":332,"children":334},{"style":333},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic",[335],{"type":46,"value":336},"   # or \u002Fusr\u002Flocal\u002Fbin if sudo works\n",{"type":41,"tag":49,"props":338,"children":339},{},[340,346],{"type":41,"tag":67,"props":341,"children":343},{"className":342},[],[344],{"type":46,"value":345},"brew install aria2",{"type":46,"value":347}," (optional) makes downloads much faster; xcodes uses it automatically when present.",{"type":41,"tag":49,"props":349,"children":350},{},[351,353,359,360,366],{"type":46,"value":352},"Verify: ",{"type":41,"tag":67,"props":354,"children":356},{"className":355},[],[357],{"type":46,"value":358},"\u002Ftmp\u002Fcbin\u002Fxcodes version",{"type":46,"value":106},{"type":41,"tag":67,"props":361,"children":363},{"className":362},[],[364],{"type":46,"value":365},"\u002Ftmp\u002Fcbin\u002Fxcodes list | tail",{"type":46,"value":367}," (the list works unauthenticated; confirm your target version appears).",{"type":41,"tag":55,"props":369,"children":371},{"id":370},"_3-try-unattended-first",[372],{"type":46,"value":373},"3. Try unattended first",{"type":41,"tag":49,"props":375,"children":376},{},[377],{"type":46,"value":378},"If this machine has installed Xcode via xcodes before, the Apple ID session is already in the keychain and no sign-in is needed:",{"type":41,"tag":191,"props":380,"children":382},{"className":193,"code":381,"language":195,"meta":196,"style":196},"export PATH=\"\u002Ftmp\u002Fcbin:\u002Fopt\u002Fhomebrew\u002Fbin:$PATH\"\nxcodes install \u003CVERSION> --directory \u002FApplications --experimental-unxip \u003C \u002Fdev\u002Fnull\n",[383],{"type":41,"tag":67,"props":384,"children":385},{"__ignoreMap":196},[386,426],{"type":41,"tag":202,"props":387,"children":388},{"class":204,"line":205},[389,395,401,406,411,416,421],{"type":41,"tag":202,"props":390,"children":392},{"style":391},"--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA",[393],{"type":46,"value":394},"export",{"type":41,"tag":202,"props":396,"children":398},{"style":397},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[399],{"type":46,"value":400}," PATH",{"type":41,"tag":202,"props":402,"children":403},{"style":251},[404],{"type":46,"value":405},"=",{"type":41,"tag":202,"props":407,"children":408},{"style":251},[409],{"type":46,"value":410},"\"",{"type":41,"tag":202,"props":412,"children":413},{"style":215},[414],{"type":46,"value":415},"\u002Ftmp\u002Fcbin:\u002Fopt\u002Fhomebrew\u002Fbin:",{"type":41,"tag":202,"props":417,"children":418},{"style":397},[419],{"type":46,"value":420},"$PATH",{"type":41,"tag":202,"props":422,"children":423},{"style":251},[424],{"type":46,"value":425},"\"\n",{"type":41,"tag":202,"props":427,"children":428},{"class":204,"line":236},[429,434,439,444,449,454,459,464,469,474,478],{"type":41,"tag":202,"props":430,"children":431},{"style":209},[432],{"type":46,"value":433},"xcodes",{"type":41,"tag":202,"props":435,"children":436},{"style":215},[437],{"type":46,"value":438}," install",{"type":41,"tag":202,"props":440,"children":441},{"style":251},[442],{"type":46,"value":443}," \u003C",{"type":41,"tag":202,"props":445,"children":446},{"style":215},[447],{"type":46,"value":448},"VERSIO",{"type":41,"tag":202,"props":450,"children":451},{"style":397},[452],{"type":46,"value":453},"N",{"type":41,"tag":202,"props":455,"children":456},{"style":251},[457],{"type":46,"value":458},">",{"type":41,"tag":202,"props":460,"children":461},{"style":215},[462],{"type":46,"value":463}," --directory",{"type":41,"tag":202,"props":465,"children":466},{"style":215},[467],{"type":46,"value":468}," \u002FApplications",{"type":41,"tag":202,"props":470,"children":471},{"style":215},[472],{"type":46,"value":473}," --experimental-unxip",{"type":41,"tag":202,"props":475,"children":476},{"style":251},[477],{"type":46,"value":443},{"type":41,"tag":202,"props":479,"children":480},{"style":215},[481],{"type":46,"value":482}," \u002Fdev\u002Fnull\n",{"type":41,"tag":49,"props":484,"children":485},{},[486,488,494],{"type":46,"value":487},"If it completes, skip to step 6. If it prints ",{"type":41,"tag":67,"props":489,"children":491},{"className":490},[],[492],{"type":46,"value":493},"Apple ID: Missing username or a password",{"type":46,"value":495},", continue.",{"type":41,"tag":55,"props":497,"children":499},{"id":498},"_4-hand-sign-in-to-the-user-via-a-shared-terminal",[500],{"type":46,"value":501},"4. Hand sign-in to the user via a shared terminal",{"type":41,"tag":49,"props":503,"children":504},{},[505,507,512],{"type":46,"value":506},"Apple requires an Apple ID for every Xcode download; app-specific passwords do ",{"type":41,"tag":119,"props":508,"children":509},{},[510],{"type":46,"value":511},"not",{"type":46,"value":513}," work (xcodes needs a real session with 2FA). Don't collect credentials in chat — share a terminal:",{"type":41,"tag":515,"props":516,"children":517},"ol",{},[518,531,669],{"type":41,"tag":94,"props":519,"children":520},{},[521,523,529],{"type":46,"value":522},"Call the ",{"type":41,"tag":67,"props":524,"children":526},{"className":525},[],[527],{"type":46,"value":528},"share_terminal",{"type":46,"value":530}," tool. It returns a browser URL and a tmux socket\u002Fsession for prepping.",{"type":41,"tag":94,"props":532,"children":533},{},[534,536],{"type":46,"value":535},"Pre-type (don't run) the install command so the user only presses Enter and answers prompts:\n",{"type":41,"tag":191,"props":537,"children":539},{"className":193,"code":538,"language":195,"meta":196,"style":196},"tmux -S '\u003CSOCKET>' send-keys -t '\u003CSESSION>' 'clear; export PATH=\"\u002Ftmp\u002Fcbin:\u002Fopt\u002Fhomebrew\u002Fbin:$PATH\"; echo \"Press Enter, then sign in with your Apple ID (2FA appears here)\"' Enter\ntmux -S '\u003CSOCKET>' send-keys -t '\u003CSESSION>' 'xcodes install \u003CVERSION> --directory \u002FApplications --experimental-unxip'\n",[540],{"type":41,"tag":67,"props":541,"children":542},{"__ignoreMap":196},[543,612],{"type":41,"tag":202,"props":544,"children":545},{"class":204,"line":205},[546,551,556,561,566,571,576,581,585,590,594,598,603,607],{"type":41,"tag":202,"props":547,"children":548},{"style":209},[549],{"type":46,"value":550},"tmux",{"type":41,"tag":202,"props":552,"children":553},{"style":215},[554],{"type":46,"value":555}," -S",{"type":41,"tag":202,"props":557,"children":558},{"style":251},[559],{"type":46,"value":560}," '",{"type":41,"tag":202,"props":562,"children":563},{"style":215},[564],{"type":46,"value":565},"\u003CSOCKET>",{"type":41,"tag":202,"props":567,"children":568},{"style":251},[569],{"type":46,"value":570},"'",{"type":41,"tag":202,"props":572,"children":573},{"style":215},[574],{"type":46,"value":575}," send-keys",{"type":41,"tag":202,"props":577,"children":578},{"style":215},[579],{"type":46,"value":580}," -t",{"type":41,"tag":202,"props":582,"children":583},{"style":251},[584],{"type":46,"value":560},{"type":41,"tag":202,"props":586,"children":587},{"style":215},[588],{"type":46,"value":589},"\u003CSESSION>",{"type":41,"tag":202,"props":591,"children":592},{"style":251},[593],{"type":46,"value":570},{"type":41,"tag":202,"props":595,"children":596},{"style":251},[597],{"type":46,"value":560},{"type":41,"tag":202,"props":599,"children":600},{"style":215},[601],{"type":46,"value":602},"clear; export PATH=\"\u002Ftmp\u002Fcbin:\u002Fopt\u002Fhomebrew\u002Fbin:$PATH\"; echo \"Press Enter, then sign in with your Apple ID (2FA appears here)\"",{"type":41,"tag":202,"props":604,"children":605},{"style":251},[606],{"type":46,"value":570},{"type":41,"tag":202,"props":608,"children":609},{"style":215},[610],{"type":46,"value":611}," Enter\n",{"type":41,"tag":202,"props":613,"children":614},{"class":204,"line":236},[615,619,623,627,631,635,639,643,647,651,655,659,664],{"type":41,"tag":202,"props":616,"children":617},{"style":209},[618],{"type":46,"value":550},{"type":41,"tag":202,"props":620,"children":621},{"style":215},[622],{"type":46,"value":555},{"type":41,"tag":202,"props":624,"children":625},{"style":251},[626],{"type":46,"value":560},{"type":41,"tag":202,"props":628,"children":629},{"style":215},[630],{"type":46,"value":565},{"type":41,"tag":202,"props":632,"children":633},{"style":251},[634],{"type":46,"value":570},{"type":41,"tag":202,"props":636,"children":637},{"style":215},[638],{"type":46,"value":575},{"type":41,"tag":202,"props":640,"children":641},{"style":215},[642],{"type":46,"value":580},{"type":41,"tag":202,"props":644,"children":645},{"style":251},[646],{"type":46,"value":560},{"type":41,"tag":202,"props":648,"children":649},{"style":215},[650],{"type":46,"value":589},{"type":41,"tag":202,"props":652,"children":653},{"style":251},[654],{"type":46,"value":570},{"type":41,"tag":202,"props":656,"children":657},{"style":251},[658],{"type":46,"value":560},{"type":41,"tag":202,"props":660,"children":661},{"style":215},[662],{"type":46,"value":663},"xcodes install \u003CVERSION> --directory \u002FApplications --experimental-unxip",{"type":41,"tag":202,"props":665,"children":666},{"style":251},[667],{"type":46,"value":668},"'\n",{"type":41,"tag":94,"props":670,"children":671},{},[672],{"type":46,"value":673},"Send the user the URL with instructions: press Enter, sign in, answer the 2FA prompt in the terminal. Mention that credentials stay between them and the prompt, the session persists in the machine keychain (future installs are unattended), and the link should be treated as sensitive.",{"type":41,"tag":55,"props":675,"children":677},{"id":676},"_5-monitor-without-nagging",[678],{"type":46,"value":679},"5. Monitor without nagging",{"type":41,"tag":49,"props":681,"children":682},{},[683,685,691,693,699,701,707,709,715],{"type":46,"value":684},"Poll the terminal, not the user: ",{"type":41,"tag":67,"props":686,"children":688},{"className":687},[],[689],{"type":46,"value":690},"tmux -S '\u003CSOCKET>' capture-pane -t '\u003CSESSION>' -p | tail",{"type":46,"value":692},". The phases are: sign-in → ",{"type":41,"tag":67,"props":694,"children":696},{"className":695},[],[697],{"type":46,"value":698},"Downloading Xcode \u003CVERSION>",{"type":46,"value":700}," (long; ~3 GB) → ",{"type":41,"tag":67,"props":702,"children":704},{"className":703},[],[705],{"type":46,"value":706},"Unarchiving Xcode (This can take a while)",{"type":46,"value":708}," → ",{"type":41,"tag":67,"props":710,"children":712},{"className":711},[],[713],{"type":46,"value":714},"xcodes requires superuser privileges",{"type":46,"value":716}," (see below) → done. Check every few minutes (scheduled wakeups, not tight loops). If the pane shows an auth error, tell the user and have them retry in the same terminal.",{"type":41,"tag":49,"props":718,"children":719},{},[720,725,727,733],{"type":41,"tag":119,"props":721,"children":722},{},[723],{"type":46,"value":724},"Sudo:",{"type":46,"value":726}," near the end xcodes asks for the ",{"type":41,"tag":728,"props":729,"children":730},"em",{},[731],{"type":46,"value":732},"macOS account",{"type":46,"value":734}," password (enable dev mode, license). If you have passwordless sudo you can pre-empt this; otherwise the user types the machine password in the same terminal — tell them which password it wants, it's a common point of confusion after just typing an Apple ID password.",{"type":41,"tag":55,"props":736,"children":738},{"id":737},"_6-post-install",[739],{"type":46,"value":740},"6. Post-install",{"type":41,"tag":191,"props":742,"children":744},{"className":193,"code":743,"language":195,"meta":196,"style":196},"sudo xcode-select --switch \u002FApplications\u002FXcode-\u003CVERSION>.app\nsudo xcodebuild -license accept\nxcodebuild -runFirstLaunch\nxcodebuild -downloadPlatform iOS        # simulator runtime, ~8 GB — only if iOS sim work is needed\nxcodebuild -version                     # verify\nxcrun simctl list devices | head        # verify simulators exist\n",[745],{"type":41,"tag":67,"props":746,"children":747},{"__ignoreMap":196},[748,793,815,828,851,869],{"type":41,"tag":202,"props":749,"children":750},{"class":204,"line":205},[751,756,761,766,771,776,780,784,788],{"type":41,"tag":202,"props":752,"children":753},{"style":209},[754],{"type":46,"value":755},"sudo",{"type":41,"tag":202,"props":757,"children":758},{"style":215},[759],{"type":46,"value":760}," xcode-select",{"type":41,"tag":202,"props":762,"children":763},{"style":215},[764],{"type":46,"value":765}," --switch",{"type":41,"tag":202,"props":767,"children":768},{"style":215},[769],{"type":46,"value":770}," \u002FApplications\u002FXcode-",{"type":41,"tag":202,"props":772,"children":773},{"style":251},[774],{"type":46,"value":775},"\u003C",{"type":41,"tag":202,"props":777,"children":778},{"style":215},[779],{"type":46,"value":448},{"type":41,"tag":202,"props":781,"children":782},{"style":397},[783],{"type":46,"value":453},{"type":41,"tag":202,"props":785,"children":786},{"style":251},[787],{"type":46,"value":458},{"type":41,"tag":202,"props":789,"children":790},{"style":215},[791],{"type":46,"value":792},".app\n",{"type":41,"tag":202,"props":794,"children":795},{"class":204,"line":236},[796,800,805,810],{"type":41,"tag":202,"props":797,"children":798},{"style":209},[799],{"type":46,"value":755},{"type":41,"tag":202,"props":801,"children":802},{"style":215},[803],{"type":46,"value":804}," xcodebuild",{"type":41,"tag":202,"props":806,"children":807},{"style":215},[808],{"type":46,"value":809}," -license",{"type":41,"tag":202,"props":811,"children":812},{"style":215},[813],{"type":46,"value":814}," accept\n",{"type":41,"tag":202,"props":816,"children":817},{"class":204,"line":295},[818,823],{"type":41,"tag":202,"props":819,"children":820},{"style":209},[821],{"type":46,"value":822},"xcodebuild",{"type":41,"tag":202,"props":824,"children":825},{"style":215},[826],{"type":46,"value":827}," -runFirstLaunch\n",{"type":41,"tag":202,"props":829,"children":831},{"class":204,"line":830},4,[832,836,841,846],{"type":41,"tag":202,"props":833,"children":834},{"style":209},[835],{"type":46,"value":822},{"type":41,"tag":202,"props":837,"children":838},{"style":215},[839],{"type":46,"value":840}," -downloadPlatform",{"type":41,"tag":202,"props":842,"children":843},{"style":215},[844],{"type":46,"value":845}," iOS",{"type":41,"tag":202,"props":847,"children":848},{"style":333},[849],{"type":46,"value":850},"        # simulator runtime, ~8 GB — only if iOS sim work is needed\n",{"type":41,"tag":202,"props":852,"children":854},{"class":204,"line":853},5,[855,859,864],{"type":41,"tag":202,"props":856,"children":857},{"style":209},[858],{"type":46,"value":822},{"type":41,"tag":202,"props":860,"children":861},{"style":215},[862],{"type":46,"value":863}," -version",{"type":41,"tag":202,"props":865,"children":866},{"style":333},[867],{"type":46,"value":868},"                     # verify\n",{"type":41,"tag":202,"props":870,"children":872},{"class":204,"line":871},6,[873,878,883,888,893,898,903],{"type":41,"tag":202,"props":874,"children":875},{"style":209},[876],{"type":46,"value":877},"xcrun",{"type":41,"tag":202,"props":879,"children":880},{"style":215},[881],{"type":46,"value":882}," simctl",{"type":41,"tag":202,"props":884,"children":885},{"style":215},[886],{"type":46,"value":887}," list",{"type":41,"tag":202,"props":889,"children":890},{"style":215},[891],{"type":46,"value":892}," devices",{"type":41,"tag":202,"props":894,"children":895},{"style":251},[896],{"type":46,"value":897}," |",{"type":41,"tag":202,"props":899,"children":900},{"style":209},[901],{"type":46,"value":902}," head",{"type":41,"tag":202,"props":904,"children":905},{"style":333},[906],{"type":46,"value":907},"        # verify simulators exist\n",{"type":41,"tag":55,"props":909,"children":911},{"id":910},"_7-clean-up",[912],{"type":46,"value":913},"7. Clean up",{"type":41,"tag":90,"props":915,"children":916},{},[917,922,935],{"type":41,"tag":94,"props":918,"children":919},{},[920],{"type":46,"value":921},"Ask the user to confirm they're done in the terminal, then rotate\u002Fkill the shared terminal link.",{"type":41,"tag":94,"props":923,"children":924},{},[925,927,933],{"type":46,"value":926},"Delete ",{"type":41,"tag":67,"props":928,"children":930},{"className":929},[],[931],{"type":46,"value":932},"\u002Ftmp\u002Fxcodes.zip",{"type":46,"value":934},". Keep the xcodes binary for future installs.",{"type":41,"tag":94,"props":936,"children":937},{},[938],{"type":46,"value":939},"Report the installed version and remaining disk space.",{"type":41,"tag":941,"props":942,"children":943},"style",{},[944],{"type":46,"value":945},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":947,"total":236},[948,964],{"slug":949,"name":949,"fn":950,"description":951,"org":952,"tags":953,"stars":25,"repoUrl":26,"updatedAt":963},"expo-tuft-development","develop and debug Expo apps on devices","Develop, build, run, and debug Expo applications on a physical device through a Tuft machine. Use for EAS account\u002FApple\u002Fdevice setup via the Tuft dashboard flow, making development builds with EAS, Expo dev-client iteration, remotely exposing Metro with `tuft host`, generating a dev-client deep link, diagnosing device-only failures with Tuft telemetry, deciding whether a native rebuild is required, and handing a working preview back to the user.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[954,957,958,959,960],{"name":955,"slug":956,"type":15},"Debugging","debugging",{"name":20,"slug":21,"type":15},{"name":9,"slug":8,"type":15},{"name":17,"slug":18,"type":15},{"name":961,"slug":962,"type":15},"React Native","react-native","2026-07-24T06:08:45.925052",{"slug":4,"name":4,"fn":5,"description":6,"org":965,"tags":966,"stars":25,"repoUrl":26,"updatedAt":27},{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[967,968,969,970],{"name":20,"slug":21,"type":15},{"name":13,"slug":14,"type":15},{"name":17,"slug":18,"type":15},{"name":23,"slug":24,"type":15},{"items":972,"total":1146},[973,991,1006,1019,1033,1047,1065,1076,1091,1109,1124,1135],{"slug":974,"name":974,"fn":975,"description":976,"org":977,"tags":978,"stars":988,"repoUrl":989,"updatedAt":990},"eas-app-stores","deploy and submit Expo apps to stores","EAS service (paid). Deploy Expo apps to the app stores with EAS - build and submit to the iOS App Store, Google Play Store, and TestFlight, configure eas.json build and submit profiles, manage app versions and build numbers, and publish App Store metadata and ASO. Use whenever the user wants to deploy, release, or ship an app to production or the app stores, is preparing a production build, running eas build or eas submit, shipping to TestFlight, bumping version or build numbers, or setting up store listing metadata. For deploying an Expo website or API routes, use the eas-hosting skill.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[979,982,983,984,987],{"name":980,"slug":981,"type":15},"Android","android",{"name":20,"slug":21,"type":15},{"name":9,"slug":8,"type":15},{"name":985,"slug":986,"type":15},"iOS","ios",{"name":17,"slug":18,"type":15},2190,"https:\u002F\u002Fgithub.com\u002Fexpo\u002Fskills","2026-07-24T05:36:44.164663",{"slug":992,"name":992,"fn":993,"description":994,"org":995,"tags":996,"stars":988,"repoUrl":989,"updatedAt":1005},"eas-hosting","deploy Expo websites to EAS Hosting","EAS service (paid). Deploy Expo websites and Expo Router API routes to EAS Hosting - export the web bundle, run eas deploy for production and PR preview URLs, manage environment secrets and custom domains, and work within the Cloudflare Workers runtime. Also covers authoring API routes (+api.ts handlers, HTTP methods, request handling, CORS). Use when deploying an Expo web app or API routes, setting up EAS Hosting, or configuring hosting environments and domains. Not for native builds or store releases - use the eas-app-stores skill for those.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[997,998,999,1002],{"name":20,"slug":21,"type":15},{"name":9,"slug":8,"type":15},{"name":1000,"slug":1001,"type":15},"Frontend","frontend",{"name":1003,"slug":1004,"type":15},"Web Development","web-development","2026-07-24T05:36:40.193701",{"slug":1007,"name":1007,"fn":1008,"description":1009,"org":1010,"tags":1011,"stars":988,"repoUrl":989,"updatedAt":1018},"eas-observe","configure EAS Observe for Expo apps","EAS service (paid). Use for anything related to EAS Observe - adding `expo-observe` to an Expo project (AppMetricsRoot\u002FObserveRoot HOC, markInteractive, the useObserve hook, the Expo Router \u002F React Navigation integrations for per-route metrics, and user-defined events via `Observe.logEvent`), querying via the EAS CLI (`eas observe:metrics-summary`, `observe:metrics`, `observe:routes`, `observe:events`, `observe:versions`), or interpreting the resulting metrics (cold\u002Fwarm launch, TTR, TTI, navigation cold\u002Fwarm TTR, update download, and the TTI frameRate params for triaging slow startups).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1012,1013,1014,1017],{"name":9,"slug":8,"type":15},{"name":17,"slug":18,"type":15},{"name":1015,"slug":1016,"type":15},"Observability","observability",{"name":961,"slug":962,"type":15},"2026-07-24T05:36:45.220605",{"slug":1020,"name":1020,"fn":1021,"description":1022,"org":1023,"tags":1024,"stars":988,"repoUrl":989,"updatedAt":1032},"eas-simulator","run and control remote iOS and Android simulators","EAS service (paid). Run and control a user's app on a remote iOS\u002FAndroid simulator hosted on EAS cloud. Read before running any `eas simulator:*` commands - it has the current syntax for this experimental API. Use whenever the user needs a simulator they can't run locally - 'run my app on a cloud simulator', 'use eas simulator to run\u002Finstall\u002Fscreenshot my app', 'I'm on Linux\u002FCursor and need an iOS device', 'no sim on this box \u002F headless CI', 'let an agent click through my app and screenshot it', 'test my dev build on a remote sim with live reload', 'stream a sim to my browser' - even when they don't say 'EAS Simulator' or 'cloud'. On a host WITHOUT a local simulator (Linux, CI, cloud sandbox) it's the default; on macOS, do NOT auto-trigger for a plain 'run on the simulator' - use it only for a cloud\u002Fremote\u002Fshareable sim, an iOS version they lack, or an agent-driven session. NOT for local sims (expo run:ios, Xcode, Android Studio), EAS Build\u002FUpdate, web preview, or physical devices.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1025,1026,1029,1030,1031],{"name":980,"slug":981,"type":15},{"name":1027,"slug":1028,"type":15},"CLI","cli",{"name":9,"slug":8,"type":15},{"name":985,"slug":986,"type":15},{"name":17,"slug":18,"type":15},"2026-07-31T05:52:18.602058",{"slug":1034,"name":1034,"fn":1035,"description":1036,"org":1037,"tags":1038,"stars":988,"repoUrl":989,"updatedAt":1046},"eas-update-insights","check health of EAS Updates","EAS service (paid). Check the health of published EAS Update: crash rates, install\u002Flaunch counts, unique users, payload size, and the split between embedded and OTA users per channel. Use when the user asks how an update is performing, whether a rollout is healthy, how many users are on the embedded build vs OTA, or wants to gate CI on update health.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1039,1042,1043,1044,1045],{"name":1040,"slug":1041,"type":15},"Analytics","analytics",{"name":20,"slug":21,"type":15},{"name":9,"slug":8,"type":15},{"name":17,"slug":18,"type":15},{"name":1015,"slug":1016,"type":15},"2026-07-24T05:36:50.17095",{"slug":1048,"name":1048,"fn":1049,"description":1050,"org":1051,"tags":1052,"stars":988,"repoUrl":989,"updatedAt":1064},"eas-workflows","configure EAS workflows for Expo projects","EAS service (paid). Helps understand and write EAS workflow YAML files for Expo projects. Use this skill when the user asks about CI\u002FCD or workflows in an Expo or EAS context, mentions .eas\u002Fworkflows\u002F, or wants help with EAS build pipelines or deployment automation.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1053,1056,1059,1060,1061],{"name":1054,"slug":1055,"type":15},"Automation","automation",{"name":1057,"slug":1058,"type":15},"CI\u002FCD","ci-cd",{"name":20,"slug":21,"type":15},{"name":9,"slug":8,"type":15},{"name":1062,"slug":1063,"type":15},"YAML","yaml","2026-07-24T05:36:43.205514",{"slug":1066,"name":1066,"fn":1067,"description":1068,"org":1069,"tags":1070,"stars":988,"repoUrl":989,"updatedAt":1075},"expo-app-clip","add iOS App Clip targets to Expo","Framework (OSS). Add an iOS App Clip target to an Expo app. Use when the user mentions App Clip, AASA, apple-app-site-association, appclips, smart app banner, or wants to ship a lightweight iOS Clip invoked from a URL alongside their parent app.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1071,1072,1073,1074],{"name":9,"slug":8,"type":15},{"name":985,"slug":986,"type":15},{"name":17,"slug":18,"type":15},{"name":961,"slug":962,"type":15},"2026-07-24T05:36:46.195935",{"slug":1077,"name":1077,"fn":1078,"description":1079,"org":1080,"tags":1081,"stars":988,"repoUrl":989,"updatedAt":1090},"expo-brownfield","integrate Expo and React Native into native apps","Framework (OSS). Integrate Expo and React Native into an existing native iOS or Android app. Use when the user mentions brownfield, embedding React Native in a native app, AAR\u002FXCFramework, or adding Expo to an existing Kotlin\u002FSwift project. Covers both the isolated approach and the integrated approach.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1082,1083,1084,1087,1088,1089],{"name":980,"slug":981,"type":15},{"name":9,"slug":8,"type":15},{"name":1085,"slug":1086,"type":15},"Integrations","integrations",{"name":985,"slug":986,"type":15},{"name":17,"slug":18,"type":15},{"name":961,"slug":962,"type":15},"2026-07-24T05:36:39.682299",{"slug":1092,"name":1092,"fn":1093,"description":1094,"org":1095,"tags":1096,"stars":988,"repoUrl":989,"updatedAt":1108},"expo-data-fetching","fetch and manage data in Expo apps","Framework (OSS). Use when implementing or debugging ANY network request, API call, or data fetching. Covers fetch API, React Query, SWR, error handling, caching, offline support, and Expo Router data loaders (`useLoaderData`).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1097,1100,1103,1104,1105],{"name":1098,"slug":1099,"type":15},"API Development","api-development",{"name":1101,"slug":1102,"type":15},"Caching","caching",{"name":9,"slug":8,"type":15},{"name":17,"slug":18,"type":15},{"name":1106,"slug":1107,"type":15},"React","react","2026-07-24T05:36:42.177188",{"slug":1110,"name":1110,"fn":1111,"description":1112,"org":1113,"tags":1114,"stars":988,"repoUrl":989,"updatedAt":1123},"expo-dev-client","build and distribute Expo development clients","Framework (OSS). Build and distribute Expo development clients locally or via TestFlight for internal testing. For production TestFlight releases and store submission, use the eas-app-stores skill.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1115,1116,1117,1118,1119,1122],{"name":980,"slug":981,"type":15},{"name":20,"slug":21,"type":15},{"name":9,"slug":8,"type":15},{"name":985,"slug":986,"type":15},{"name":1120,"slug":1121,"type":15},"Local Development","local-development",{"name":17,"slug":18,"type":15},"2026-07-24T05:36:51.160719",{"slug":1125,"name":1125,"fn":1126,"description":1127,"org":1128,"tags":1129,"stars":988,"repoUrl":989,"updatedAt":1134},"expo-dom","run web components in native apps","Framework (OSS). Use Expo DOM components to run web code in a webview on native and as-is on web. Migrate web code to native incrementally. For the end-to-end migration of a whole web app, use the expo-web-to-native skill.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1130,1131,1132,1133],{"name":9,"slug":8,"type":15},{"name":1000,"slug":1001,"type":15},{"name":17,"slug":18,"type":15},{"name":961,"slug":962,"type":15},"2026-07-24T05:36:41.176872",{"slug":1136,"name":1136,"fn":1137,"description":1138,"org":1139,"tags":1140,"stars":988,"repoUrl":989,"updatedAt":1145},"expo-examples","integrate Expo example projects","Framework (OSS). Expo's official example projects - the expo\u002Fexamples repo of ~70 `with-*` integrations (Stripe, Clerk, Supabase, OpenAI, maps, Reanimated, SQLite, Skia, NativeWind, and more). Use when integrating a third-party library or service into an existing Expo app and you want the canonical, version-matched pattern to adapt, or when scaffolding a new project from one with `npx create-expo --example`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1141,1142,1143,1144],{"name":9,"slug":8,"type":15},{"name":1085,"slug":1086,"type":15},{"name":17,"slug":18,"type":15},{"name":961,"slug":962,"type":15},"2026-07-24T05:36:35.174379",24]