argent-ios-device-interact Skill for Claude Code: Drive a Physical iPhone

Skill that tells your assistant how to drive a physical iPhone through Argent: tap, swipe, type, screenshot and read the screen.

Installs: 12.6K; on skills.sh
Stars: 3.1K; on GitHub
Updated: Oct 2026; last repo commit

It applies only when a physical iPhone is involved, never for a simulator. It lists the Argent tools that work on real hardware, the ones that do not, and quirks such as an https link opening in Safari unless you pass a bundle ID.

It is one part of Argent, from Software Mansion, and needs Argent installed with a cabled iPhone. For cable, trust or signing problems it points to argent-ios-device-setup, and for everything not covered it says argent-device-interact still applies. The folder is 1 file, SKILL.md.

Good for

React Native and iOS developers testing on a real iPhone
QA engineers reproducing a bug on hardware
Teams that need gestures a simulator cannot give

Install argent-ios-device-interact

Claude Code

Copy this prompt.

Install the argent-ios-device-interact skill in Claude Code. Run this command:

npx @swmansion/argent@latest init

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

Both Argent iPhone skills drive Argent's own tools, so install Argent, not just the skill folder. The installer installs or updates the package, writes the MCP server config for the editors you pick, offers to add Argent tools to the editor's auto-approve list, installs Argent's skills and copies its rules and agents. Say no to auto-approve if you want a prompt on every tool call. Telemetry is on by default and argent telemetry disable turns it off. In the editor step, choose Claude Code, which is one of the editors the installer lists.

From the project README. Source.

What's in the skill

When it loads

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.

Sections in SKILL.md

Contract
Tools on hardware

Key facts

Author: Software Mansion (owner of the software-mansion/argent repo; the README says Argent is created by Software Mansion)
License: Apache-2.0 for source code, with proprietary binaries described in the README
Installs on skills.sh: 12,567 as of 2026-11-02
GitHub stars: 3,138 for the whole software-mansion/argent repo, 2026-11-02
Last repo commit: 2026-10-31
Files: 1 file: SKILL.md; no scripts
Needs: Argent installed, and a physical iPhone (SKILL.md)

What it includes

Observing never changes the screen; gestures and keyboard bring the app forward again.
Describe again after a gesture, because the tree may be stale.
Read · Contract
list-devices, describe, screenshot, screenshot-diff and two await tools.
Read · Observe
Gesture tools (tap, swipe, custom, pinch, rotate), button and keyboard.
button covers home, volumeUp, volumeDown and actionButton on models that have one.
Runs code · Act
launch-app, restart-app, reinstall-app and open-url.
open-url with https lands in Safari unless you pass bundleId.
Runs code · App control
run-sequence and the e2e tools.
Runs code · Batch and e2e
stop-simulator-server and stop-all-simulator-servers.
Runs code · Session end
rotate, shake, paste, permissions, recording, debugger, profilers and boot-device.
Do those by hand or on a simulator.
Read · Not available on hardware

From the official docs

Permissions

Medium risk

It lets the assistant tap, type and launch apps on a real iPhone, and the installer offers to approve those tools without prompts. Use a test phone and decline auto-approve if you want to confirm each action.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It controls a real phone, not a simulator
The tools tap, type and press buttons on your iPhone, and can launch, restart and reinstall apps. Use a test device and keep the screen where you can see it. github.com
The installer can auto-approve Argent tools
The installer asks whether to add Argent tools to the editor's auto-approve list and defaults to yes. Decline it if you want to confirm each tap yourself. github.com
Argent collects usage telemetry by default
The README says telemetry is opt-out with argent telemetry disable. The privacy notice lists which tools are invoked, whether they succeed and which AI tool drives Argent. github.com

Technical details

Scopes	Taps, swipes, pinches, types and presses home, volume and action buttons on a connected iPhone Launches, restarts and reinstalls apps and opens URLs on the phone Takes screenshots and reads the on-screen element tree The Argent installer writes MCP config files, rules and agents, and optionally editor auto-approve lists

Questions

What does the argent-ios-device-interact skill do?

It tells your assistant how to drive a physical iPhone through Argent. It lists the tools that work on real hardware, such as tap, swipe, keyboard and screenshot, and the ones that do not.

How do I install it?

Use the install box at the top of this page. It installs Argent, which includes this skill and the skills it points to, and sets up the tools the skill calls.

Does it work with a simulator?

No. The description says to use it only for a physical iPhone and never for a simulator.

Do I need to set up the iPhone first?

Yes, for the first run. SKILL.md sends you to argent-ios-device-setup for cable, trust and signing problems.

Is it safe?

It lets the assistant tap, type and launch or reinstall apps on a real iPhone. Use a test device, and decline the installer's auto-approve option if you want to confirm each action. Argent also sends usage telemetry unless you disable it.

Why is there no Claude app install?

The skill drives Argent's tools on your computer and a cabled phone, so a folder upload alone does nothing. The box lists the Argent installer.

Information

updated Nov 2, 2026

Repository: software-mansion/argent
Folder: packages/skills/skills/argent-ios-device-interact

software-mansion/argent skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 6

README.md · github.com
init.ts · github.com
mcp-configs.ts · github.com
SKILL.md · github.com
Telemetry.md · github.com
init-allowlist.ts · github.com