Drive a physical iPhone through argent. Use when a physical iPhone is involved (a list-devices iOS entry with kind "device") and ONLY then; never for a simulator. For cable, trust, or signing problems read argent-ios-device-setup.
Read this only for a physical iPhone. argent-device-interact still applies for everything not listed here.
Contract
Observation never changes the screen; mutation may. describe and await-ui-element fail on a backgrounded target instead of re-fronting it; await-screen-idle returns settled: false with no reason. The first describe within a second of button home can still return the old tree; describe again. Gestures and keyboard re-front it and return reactivated: true; re-describe before the next step.
launch-app, open-url and restart-app set the app under automation; reinstall-app clears it; a tool-server restart forgets it: launch again.
Each tool's description states its own hardware limits (named keys, gesture-custom shapes, buttons, edge swipes, tap counts). A gated tool fails with a bare not supported on ios device: the fix is in the list below, not in the error.
Tools on hardware
Only these exist: list-devices, launch-app, restart-app, reinstall-app, open-url, describe, screenshot, screenshot-diff, gesture-tap, gesture-swipe, gesture-custom, button (home, volumeUp, volumeDown, actionButton on models that have one), keyboard, await-ui-element, await-screen-idle, run-sequence, the flow tools, stop-simulator-server and stop-all-simulator-servers (session end). Every other device tool fails with not supported on ios device.
No two-finger gestures, rotate, shake, paste, settings-permissions, screen recording, debugger-*, react-profiler-*, native-profiler-*, native-*, boot-device: drive the app's own zoom and rotate UI with taps and drags, move the phone by hand, type with keyboard, change permissions in the phone's Settings, and debug, profile or record on a simulator.
gesture-swipe: durationMs sets drag speed, not time; momentum:false only rests 300 ms at the end, no damping. open-url https lands in Safari, never in the app that owns the link: pass bundleId.
argent-android-emulator-setupsoftware-mansionSet up and connect to an Android emulator using argent MCP tools. Use when starting a new session on Android, booting an emulator, getting a device serial, or before any UI interaction task.22.3 k22.3 k instalaciones en skills.sh0
argent-react-native-optimizationsoftware-mansionOptimizes a React Native app by profiling first to find real bottlenecks, then sweeping for mechanical issues. Entry-point for all performance work. Use when the app feels slow, user asks to optimize, fix re-renders, reduce jank, or improve startup. Delegates to argent-react-native-profiler for measurement.22.2 k22.2 k instalaciones en skills.sh0
argent-ios-simulator-setupsoftware-mansionSet up and connect to an iOS simulator using argent MCP tools. Use when starting a new session, booting an iOS simulator, getting an iOS UDID, or before any iOS simulator interaction task.22.1 k22.1 k instalaciones en skills.sh0
argent-react-native-app-workflowsoftware-mansionStep-by-step workflows for developing or debugging React Native apps on iOS simulator or Android emulator. Use when starting the app, debugging Metro, fixing builds, diagnosing runtime errors, or running tests.22.1 k22.1 k instalaciones en skills.sh0
argent-create-flowsoftware-mansionCreate, record, edit, replay, or repair reusable Argent flow YAML files. Use when the user asks to record or replay a repeatable device path, set up profiling or an A/B comparison, or invoke the authoring engine behind argent-qa-flows. Also use before repeating three or more interactions. For one-off UI checks, acceptance-driven regression tests, or screen video, use argent-test-ui-flow, argent-qa-flows, or argent-screen-recording respectively.22 k22 k instalaciones en skills.sh0
