How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/software-mansion/argent --skill argent-ios-device-interactBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
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, 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,gesture-pinch,gesture-rotate,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
rotate(the orientation tool),shake,paste,settings-permissions, screen recording,debugger-*,react-profiler-*,native-profiler-*,native-*,boot-device: move the phone by hand, type withkeyboard, change permissions in the phone's Settings, and debug, profile or record on a simulator.