argent-ios-device-setup Skill for Claude Code: Prepare a Cabled iPhone

Skill that walks your assistant through cabling, trusting and signing a physical iPhone so Argent can control it.

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 first-run steps: cable and unlock the phone, turn on Developer Mode, and wait while Argent builds, signs and starts a runner app on the phone. It also gives fixes for common signing and build errors.

It is one part of Argent, from Software Mansion, and needs Argent installed. When setup is done it sends the assistant to argent-ios-device-interact. The folder is 1 file, SKILL.md.

Good for

iOS and React Native developers connecting a real iPhone for the first time
Developers hitting Xcode signing or trust errors with Argent
QA engineers preparing a test device

Install argent-ios-device-setup

Claude Code

Copy this prompt.

Install the argent-ios-device-setup 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

Set up a cabled physical iPhone for argent. Use when a physical iPhone is involved (a list-devices iOS entry with kind "device") and ONLY then; never for a simulator.

Sections in SKILL.md

First run
Signing and failures

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,559 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, a cable, an unlocked iPhone with Developer Mode (SKILL.md)

What it includes

Cable it, unlock it, keep the screen awake and turn on Developer Mode.
list-devices must show the phone as connected.
Read · Step 1: Prepare the phone
The first describe, gesture or screenshot builds, signs and starts the runner.
Build cap is 15 minutes and runner ready time is 120 seconds.
Runs code · Step 2: First build
Approve the developer on the phone; an Argent Runner app appears.
Read · Step 3: Trust the developer
Needs no configuration; ARGENT_IOS_TEAM_ID overrides the team it picks.
A change to the override forces a cold rebuild.
Read · Signing
errSecInternalComponent: run security set-key-partition-list on the login keychain.
Asks for your login password.
Runs code · Keychain fix
Team has no devices, bundle ID registration failures, runner log path and RUNNER_WEDGED.
Read · Other fixes
Hands off to argent-ios-device-interact once setup is done.
Read · Next skill

From the official docs

Permissions

Medium risk

It signs and installs a runner app on your iPhone with your Apple team, and one fix changes a keychain setting after you enter your login password. Approve each step and use a test phone.

What it can do

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

Watch out for

It may change your keychain settings
For the errSecInternalComponent error, SKILL.md runs security set-key-partition-list on the login keychain with apple-tool:, apple: and codesign: partitions. It asks for your login password. Read the command before you approve it. github.com
It installs an app on your phone and signs it with your team
The first call builds and signs a runner, and an Argent Runner app appears on the iPhone, which SKILL.md says must stay installed. It mentions bundle ID registration and a free-team app-id cap. github.com
You must trust the developer on the phone
The phone asks you to trust the developer in Settings. Only do this for a phone and Apple account you control. github.com
Argent collects usage telemetry by default
The README says telemetry is opt-out with argent telemetry disable. github.com

Technical details

Scopes	Builds, signs and installs an on-device runner app called Argent Runner on your cabled iPhone Signs with an Apple team it picks; ARGENT_IOS_TEAM_ID overrides the choice May run security set-key-partition-list on your login keychain, which asks for your login password Reads runner logs under ~/.argent/ios-device-runner/logs/

Questions

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

It guides your assistant through preparing a cabled physical iPhone for Argent. That covers Developer Mode, the first runner build, trusting the developer and common signing errors.

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.

Do I need to configure signing?

No. SKILL.md says signing needs no configuration. The first phone call names the team it picked, and ARGENT_IOS_TEAM_ID overrides that choice.

What is the Argent Runner app on my phone?

SKILL.md says it is Argent's automation runner and must stay installed. It appears on the home screen after the first install.

Is it safe?

It signs and installs a runner app on your iPhone with your Apple team. One fix runs a keychain command that asks for your login password. Use a test phone and read each command before you approve it.

Does it work with simulators?

No. SKILL.md says to use it only for a physical iPhone. Simulators use argent-ios-simulator-setup.

Information

updated Nov 2, 2026

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

software-mansion/argent skills.sh

Sources

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

Show all 5

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