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

argent-ios-device-interact — Claude Code skill: install

Drives a physical iPhone through argent for app checks, gestures, screenshots, and UI waits. Use it when the target is a real device, not a simulator.

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

What argent-ios-device-interact does

This skill defines how argent interacts with a physical iPhone. The agent can list devices, launch, restart, or reinstall an app, open a URL, take screenshots, compare them, inspect the UI tree, and wait for an element or an idle screen.

Available hardware actions include taps, swipes, custom gestures, Home and volume buttons, keyboard input, action sequences, and e2e tools. Gestures and keyboard input can bring the app back to the foreground, so the UI should be described again afterward. The first describe after button home can still show the previous tree.

Use this skill only with a physical iPhone. Hardware mode does not support rotation, two-finger gestures, paste, screen recording, or debugging tools. Cable, trust, and signing issues belong to argent-ios-device-setup; check the selected device before starting a run.

What it helps with

  • check an app on a physical iPhone
  • launch an app on a connected device
  • perform gestures and keyboard input
  • wait for a UI element or idle screen
  • compare screenshots after an action

Example prompts for the agent

  • Use argent to check the connected physical iPhone, launch the app, and describe its UI tree.
  • Swipe across the screen, enter the requested text with the keyboard, then describe the UI again.
  • Run the e2e flow on the physical iPhone and wait for the target element before continuing.

How to install argent-ios-device-interact

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

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

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-interact

How do I install argent-ios-device-interact in Claude Code?

Run npx skills add software-mansion/argent --skill argent-ios-device-interact -a claude-code, then run npx skills add software-mansion/argent --skill argent-ios-device-interact -a claude-code again. The skill file is at ~/.claude/skills/argent-ios-device-interact/SKILL.md.

What does argent-ios-device-interact do?

It defines argent workflows for a physical iPhone, including app control, gestures, keyboard input, screenshots, UI inspection, and state waits.

Can I use this skill with an iOS simulator?

No. It is for physical iPhones only; simulator work uses a different set of rules and tools.

Source text

SKILL.md · Apache-2.0 
---
name: argent-ios-device-interact
description: 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.
---

# Physical iPhone interaction

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 e2e 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`.

© 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