Skip to main content
affpapa.org
RU EN
skill Claude Code CX Codex Cursor GitHub Copilot

argent-ios-device-setup — Claude Code skill: how to install

Guides coding agents through setting up a cabled physical iPhone for argent automation. Essential when testing on real hardware instead of an iOS simulator.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add software-mansion/argent --skill argent-ios-device-setup -a claude-code
Open on GitHub

What argent-ios-device-setup does

This skill guides the agent through preparing a physical iPhone connected via USB cable for argent automation runs. It applies strictly to hardware devices recognized by list-devices with the device kind; never run it against a simulator. The device must stay unlocked with Developer Mode enabled before proceeding.

Calling launch-app registers the application, while the first gesture or screenshot triggers building and signing the on-device Argent Runner. Cold builds cap at 15 minutes, and runner readiness takes up to 120 seconds. Once installed, the Argent Runner app appears on the home screen and requires manual developer trust confirmation in iOS settings.

Free developer accounts frequently trigger bundle identifier registration caps, forcing either a multi-day wait or a paid team configuration. The skill provides remediation commands for keychain failures like errSecInternalComponent via security set-key-partition-list. Raw build failures can be inspected directly in ~/.argent/ios-device-runner/logs/runner-<udid8>.log.

What it helps with

  • configure a cabled physical iPhone for argent automation
  • resolve the errSecInternalComponent keychain signing failure
  • build and sign the Argent Runner app on real iOS hardware
  • diagnose xcodebuild errors using local runner log files

Example prompts for the agent

  • Set up my cabled iPhone for argent automation
  • Troubleshoot the xcodebuild signing error for Argent Runner
  • Check if my connected iOS device is ready for argent gestures

How to install argent-ios-device-setup

1Skills CLI (Vercel)

npx skills add software-mansion/argent --skill argent-ios-device-setup -a claude-code

2Manually: put the files in place

~/.claude/skills/argent-ios-device-setup/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/argent-ios-device-setup/

From the same set15

The whole set →
argent-android-emulator-setup software-mansion This skill connects an Android emulator through argent MCP tools. Use it to find a device or boot an AVD before working with an Android UI. Claude Code CX Codex Cursor +1 26,500installs argent-react-native-optimization software-mansion Profiles React Native apps to pinpoint runtime bottlenecks and fixes mechanical code issues. It steps in when user screens stutter, startup lags, or re-renders spike. Claude Code CX Codex Cursor +1 26,400installs argent-react-native-profiler software-mansion Profiles a React Native Hermes app to measure re-renders and CPU use. Use it to compare a fix, find slow components, or inspect hotspots. Claude Code CX Codex Cursor +1 26,300installs argent-react-native-app-workflow software-mansion Provides step-by-step procedures for building, running, and debugging React Native apps on iOS simulators or Android emulators. Helps resolve Metro issues and build crashes. Claude Code CX Codex Cursor +1 26,300installs argent-ios-simulator-setup software-mansion A skill for connecting to an iOS simulator via argent MCP tools. Use it to find a booted simulator, get its UDID, and prepare for any interaction task. Claude Code CX Codex Cursor +1 26,300installs argent-native-profiler software-mansion Profiles native performance on iOS and Android to find CPU hotspots and UI hangs. It also analyzes memory leaks on iOS. Claude Code CX Codex Cursor +1 26,200installs argent-metro-debugger software-mansion A skill that connects a debugger to a JS runtime via CDP. Inspect React components, read console logs, and evaluate code live. Works with React Native (iOS, Android, Vega) and Chromium apps (Electron, browsers). Claude Code CX Codex Cursor +1 26,200installs argent-test-ui-flow software-mansion A skill for autonomous iOS and Android UI testing in Claude Code. Runs interact-screenshot-verify loops through argent MCP tools to check flows and screens. Claude Code CX Codex Cursor +1 26,200installs

Similar

react-native vercel-labs This skill turns JSON specs into native React Native mobile UIs. Use it when screens need state bindings, conditional visibility, and actions. Claude Code CX Codex Cursor +1 3,200installs ios-simulator callstack Launch, inspect, and debug native, React Native, Expo, and Flutter apps on iOS Simulator from your agent. The agent can tap, type, scroll, validate code changes, and collect error logs. Claude Code CX Codex Cursor +1 5,100installs android-emulator callstack This skill drives an Android Emulator with agent-device: it launches apps, checks live UI, and gathers debugging evidence. It fits native, React Native, Expo, and Flutter apps. Claude Code CX Codex Cursor +1 4,600installs appllama-app-design-skill Appllama (appllama.io) Skill for building native iOS and Android screens with Expo and React Native. Designs with Apple HIG fidelity, semantic colors, Reanimated motion, proper navigation semantics, and simulator-verified iteration. Claude Code CX Codex Cursor +1 4,700installs android-native-dev MiniMax-AI Guides AI agents through native Android development: project scaffolding, Gradle setup, Jetpack Compose dependencies, and product flavors. Claude Code CX Codex Cursor +1 2,700installs eas-update expo Skill for configuring and publishing updates via EAS Update. Delivers JavaScript and asset changes to installed apps without rebuilding native code. Claude Code CX Codex Cursor +1 10,600installs vercel-react-native-skills vercel A rules pack for React Native and Expo work: lists, animations, navigation, native modules. Load it so your agent makes mobile changes the same way every time. Claude Code CX Codex Cursor +1 253,900installs animate-expo emilkowalski Builds React Native and Expo animations using Reanimated and Gesture Handler. Helps keep motion on the UI thread and avoid dropped frames on physical devices. Claude Code CX Codex Cursor +1 135,900installs

Questions about argent-ios-device-setup

How to install argent-ios-device-setup in Claude Code?

Run npx skills add software-mansion/argent --skill argent-ios-device-setup -a claude-code in your terminal.

What does argent-ios-device-setup do?

It provides step-by-step procedures to cable and unlock an iPhone, compile the Argent Runner, and troubleshoot code signing issues.

Does argent-ios-device-setup work with iOS simulators?

No, it is designed exclusively for physical iPhone hardware. For simulator setups, use argent-ios-simulator-setup.

Source text

SKILL.md · Apache-2.0 
---
name: argent-ios-device-setup
description: Set up a cabled physical iPhone for argent. Use when a physical iPhone is involved (a list-devices iOS entry with kind "device") and ONLY then; never for a simulator.
---

# Physical iPhone setup

Read this only for a physical iPhone. Simulators use `argent-ios-simulator-setup`.

## First run

1. Cable the phone, unlock it, keep the screen awake, and turn on Developer Mode (Settings > Privacy & Security > Developer Mode). `list-devices` must show it `connected`.
2. `launch-app` only registers the app. The first `describe`, gesture or `screenshot` builds, signs and starts the on-device runner: minutes cold, tens of seconds from cache or after a tool-server restart. Build cap 15 min, runner ready 120 s.
3. On the first install the phone asks to trust the developer (Settings > General > VPN & Device Management), and an **Argent Runner** app appears on the home screen. Tell the user it is argent's automation runner and must stay installed.

## Signing and failures

Signing needs no configuration. The first phone call of a tool-server process carries a note naming the team picked and the `ARGENT_IOS_TEAM_ID` override (tool-server environment; a change forces a cold rebuild). Cable, lock, trust, expired-profile and missing-certificate errors name their fix: apply it, retry the same call. Also: `errSecInternalComponent`: run `security set-key-partition-list -S apple-tool:,apple:,codesign: -s ~/Library/Keychains/login.keychain-db` (asks the user's login password), retry. `team has no devices`: keep the phone cabled, retry. Bundle id registration failed: free-team app-id cap, wait days or sign under a paid team. Any other xcodebuild failure prints raw `error:` lines: read `~/.argent/ios-device-runner/logs/runner-<udid8>.log`. `RUNNER_WEDGED`: `stop-simulator-server` for the udid, retry.

Then read `argent-ios-device-interact`.

© software-mansion · Apache-2.0 · software-mansion/argent

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor