Argent Ios Device Setup

by software-mansioncb0f538ad083No licenseListed Oct 8, 2026Updated Oct 8, 2026

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.

Instructions onlySoftware Development
AI-generated overview

Guides first-time setup of a cabled physical iPhone for the argent automation runner.

What it does
This skill walks through preparing a cabled, unlocked physical iPhone for argent: enabling Developer Mode, confirming the device shows as connected, and understanding that the first describe, gesture, or screenshot call builds, signs, and starts an on-device runner. It explains trusting the developer on first install, the ArgentRunner app that must stay installed, and how signing picks a team with an ARGENT_IOS_TEAM_ID override. It also lists common cable, lock, trust, profile, certificate, and xcodebuild failures with their fixes and log locations.
When to use it
Use it when a physical iPhone is involved, specifically when list-devices shows an iOS entry with kind "device". It is not for simulators, which use the separate simulator setup skill.
Requirements
Requires a cabled physical iPhone with Developer Mode enabled and the argent tooling (list-devices, launch-app, describe, gesture, screenshot, stop-simulator-server). Signing uses the tool-server environment variable ARGENT_IOS_TEAM_ID optionally, and troubleshooting may need the macOS security command and access to ~/.argent/ios-device-runner/logs. No scripts are shipped; instructions only.

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 ArgentRunner 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.

Source and attribution

Source:software-mansion/argentinpackages/skills/skills/argent-ios-device-setupat commitcb0f538

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

More from software-mansion/argent

Argent Tv Interact

software-mansion

Drives and inspects TV apps on Apple TV, Android TV and Fire TV using focus-based remote navigation and screenshots.

Software DevelopmentOct 8, 2026

Argent Settings Permissions

software-mansion

Grants, denies, or resets app runtime permissions on iOS simulators and Android devices for test setup.

Software DevelopmentOct 8, 2026

Argent Screenshot Diff

software-mansion

Compares saved or live app screenshots with the argent screenshot-diff tool to surface pixel-visible UI changes.

Software DevelopmentOct 8, 2026

Argent Screen Recording

software-mansion

Records video of an iOS simulator or Android emulator/device screen via argent MCP tools, with optional touch overlays and static-frame trimming.

Software DevelopmentOct 8, 2026

Argent React Native Profiler

software-mansion

Profiles React Native Hermes apps to measure re-renders and CPU performance and produce a ranked issue report.

Software DevelopmentOct 8, 2026

Argent React Native Optimization

software-mansion

Optimizes a React Native app by profiling to find real bottlenecks, then sweeping for mechanical issues.

Software DevelopmentOct 8, 2026

More in Software Development

Playground

anthropics

Featured

Builds self-contained interactive HTML playgrounds with controls, live preview, and copyable prompt output.

Software Development37Kupdated today

M5 Onboard

anthropics

Featured

Provisions M5Stack ESP32 boards by detecting them on USB, flashing UIFlow 2.0 firmware, and installing a MicroPython app bundle.

Software Development37Kupdated today

Cardputer Buddy

anthropics

Featured

Guides iterating on a Cardputer-Adv MicroPython app bundle: adding apps, pushing files over USB-serial, tailing logs, and running REPL commands.

Software Development37Kupdated today

Dpop Adoption

google

Featured

Guides implementation of OAuth 2.0 DPoP (RFC 9449) sender-constrained refresh tokens for Google's OAuth platform.

Software Development21Kupdated today

Gemini Live Api

google

Featured

Generates a Gemini Live API WebSocket client class, tests, docs, and a demo UI for bidirectional streaming.

Software Development21Kupdated today

Gemini Api

google

Featured

Guides use of the Gemini API on Google's Agent Platform with the Gen AI SDK across languages and capabilities.

Software Development21Kupdated today
Argent Ios Device Setup Agent Skill | SourceWeft