argent-ios-device-interact
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.
- Installs
- 11.3K
- Last 24h
- +290
- Trending rank
- #1002
- Security
- Pass
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/software-mansion/argent --skill argent-ios-device-interact- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads argent-ios-device-interact automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
Security audits
Independent scans of the skill's instructions and bundled files.
SKILL.md
The instructions your agent reads when the skill is triggered.
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.
describeandawait-ui-elementfail on a backgrounded target instead of re-fronting it;await-screen-idlereturnssettled: falsewith no reason. The firstdescribewithin a second ofbutton homecan still return the old tree; describe again. Gestures andkeyboardre-front it and returnreactivated: true; re-describe before the next step. launch-app,open-urlandrestart-appset the app under automation;reinstall-appclears it; a tool-server restart forgets it: launch again.- Each tool's description states its own hardware limits (named keys,
gesture-customshapes, buttons, edge swipes, tap counts). A gated tool fails with a barenot 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,actionButtonon models that have one),keyboard,await-ui-element,await-screen-idle,run-sequence, the e2e tools,stop-simulator-serverandstop-all-simulator-servers(session end). Every other device tool fails withnot 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 withkeyboard, change permissions in the phone's Settings, and debug, profile or record on a simulator. gesture-swipe:durationMssets drag speed, not time;momentum:falseonly rests 300 ms at the end, no damping.open-urlhttps lands in Safari, never in the app that owns the link: passbundleId.
FAQ
What does the argent-ios-device-interact skill do?
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.
How do I install argent-ios-device-interact?
Run npx skills add https://github.com/software-mansion/argent --skill argent-ios-device-interact in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/argent-ios-device-interact/ (personal) or .claude/skills/argent-ios-device-interact/ (project).
Which AI agents can use argent-ios-device-interact?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is argent-ios-device-interact safe to install?
Security partners have reviewed it: Gen Agent Trust Hub passed; Socket passed; Snyk passed. As with any skill, read the SKILL.md and bundled scripts before installing.
Who maintains argent-ios-device-interact?
It is published by software-mansion in software-mansion/argent. It has 11,347 recorded installs.
More from software-mansion/argent
argent-android-emulator-setup
software-mansion/argent
Set 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.
argent-react-native-optimization
software-mansion/argent
Optimizes 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.
argent-ios-simulator-setup
software-mansion/argent
Set 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.
argent-react-native-app-workflow
software-mansion/argent
Step-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.
argent-device-interact
software-mansion/argent
Interact with an iOS simulator, Android emulator, or Chromium (CDP) app using argent MCP tools. Use when tapping UI elements, performing gestures, scrolling/swiping, typing text, pressing hardware buttons, launching apps, opening URLs, taking screenshots, waiting for an element to appear or disappear, or checking visible app state after interactions. Not for TV targets.
argent-react-native-profiler
software-mansion/argent
Profile a React Native Hermes app to measure re-render and CPU performance using argent profiler tools. Use when optimizing for performance, measuring before/after a fix, spotting slow components, diagnosing re-renders, checking CPU hotspots, or producing a ranked issue report.
Popular mobile skills
design-mobile-apps
designed-by-ai/skills
Design mobile app screens with Sleek, edit Sleek projects, and implement their designs in React Native or HTML.
ios-design
uizze.sh
Design and review iOS UI/UX for iPhone apps in SwiftUI, UIKit, or React Native. Use for mobile app design, screen redesigns, navigation flows, typography, forms, keyboard and safe-area layout, and accessibility checks. Apply Apple Human Interface Guidelines and consult real product references through the optional Uizze connection.
vercel-react-native-skills
vercel-labs/agent-skills
React Native and Expo best practices for building performant mobile apps. Use when building React Native components, optimizing list performance, implementing animations, or working with native modules. Triggers on tasks involving React Native, Expo, mobile performance, or native platform APIs.
animate-expo
emilkowalski/skills
Build animations in React Native and Expo, making the decisions in the order that determines whether they feel right — should it animate, which thread it runs on, which properties, spring or timing, how the gesture hands off, how it degrades. Writes the implementation with Reanimated, Gesture Handler, Expo Router and expo-haptics. Use when animating anything in an Expo app, adding gestures, sheets, screen transitions, press feedback or haptics, or fixing motion that stutters on device. For web animation use animate.
xcode-project-setup
firebase/agent-skills
Safely modifies Xcode projects (.pbxproj) to add Swift Packages and link files. Use this skill whenever an iOS project needs dependencies installed (e.g. Firebase, Alamofire).
firebase-remote-config-basics
firebase/agent-skills
Manages Firebase Remote Config templates, feature flags, loading strategies, and SDKs (Android, iOS). Use when downloading/deploying remoteconfig JSON templates, managing version history/feature flags, setting in-app defaults, fetchAndActivate(), real-time listeners, or SDK setup. Don't use for Firebase Hosting, Auth, Firestore, Data Connect, Crashlytics, or App Hosting.