Argent Settings Permissions Skill for iOS and Android Testing

argent-settings-permissions teaches the assistant to grant, deny or reset an app's permissions on an iOS simulator or Android device without opening Settings.

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

The skill tells the assistant when and how to use Argent's settings-permissions tool. That tool edits the platform's permission store directly: the iOS simulator's TCC database, or Android's permission flags over adb. It supports 11 permissions, from camera and microphone to location-always and reminders.

It loads for test setup that the app cannot do itself: pre-authorize a permission before launch, deny it up front, re-enable one the user already denied, or reset it so the prompt appears again. If the app has its own toggle or a permission dialog is on screen, the skill says to tap that instead.

It needs Argent, a booted iOS simulator or an Android emulator or device, and the app's bundle id or package name. It does not apply to real iPhones.

Good for

Mobile developers who test permission flows such as camera, location or notifications
React Native teams using Argent to drive simulators and emulators
QA engineers who need the same permission state before every test run

Install argent-settings-permissions

Claude Code

Copy this prompt.

Install the argent-settings-permissions 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 20.12 or later, Xcode (iOS) or Android platform tools (Android).

This skill drives the settings-permissions tool of Argent, so install Argent first with the init wizard. It installs the package globally, registers the Argent tool server in your editor and copies the Argent skills into your workspace. The skills CLI command alone installs only this skill, without the tool.

From the project README. Source.

What's in the skill

When it loads

Grant, deny, or reset an app's runtime permissions (camera, microphone, photos, contacts, notifications, calendar, location, location-always, media-library, motion, reminders) on an iOS simulator or Android device using the argent `settings-permissions` tool - without navigating the system Settings UI. Use when the permission cannot be changed through the app itself - and only then, pre-authorize before the app asks, deny up front, re-enable a permission the user already denied, or reset so the prompt reappears. If the app can flip it - via an in-app toggle or the system permission dialog the app triggers - interact with the app instead.

Sections in SKILL.md

What this tool is for
When to use it - and when NOT to
Supported permissions & platform coverage
Actions
Parameters
Platform behavior
Gotchas
Result
Examples

Key facts

Author: Software Mansion (GitHub: software-mansion)
Repo: software-mansion/argent
Installs on skills.sh: 20,705 as of 2026-11-02
GitHub stars (whole repo): 3,138 as of 2026-11-02
License: Apache-2.0 (source); proprietary bundled binaries
Last repo commit: 2026-10-31
Files in the skill folder: 1 file including SKILL.md
skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk warn

What it includes

Pre-authorize a permission so the app never asks
Requires the bundle id or package name. Use it before launching the app.
Runs code · grant
Refuse a permission to test the denied path
On iOS it also suppresses the prompt. On Android it clears the grant, but the next request still shows the dialog.
Runs code · deny
Return a permission to not-yet-asked, per app
The dialog reappears on next use. On Android below API 33 it cannot clear a "don't ask again" state.
Runs code · reset
When to use the tool and when to tap in the app instead
Seven rules, first match wins. In-app toggles and on-screen permission dialogs come first.
Decision table
11 permissions mapped to iOS TCC services and Android names
Notifications are unsupported on iOS and reminders are unsupported on Android.
Permission coverage table
Changing a permission can terminate the running app
Set permissions before launch-app, or restart the app afterwards. Granting location on iOS needs the app installed first.
Gotchas

From the official docs

Permissions

Medium risk

The skill makes the assistant change app permissions on a simulator, emulator or connected Android device, which can end a running app. Point it at test devices only and check the device id first.

What it can do

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

Watch out for

It edits permissions on a real Android device
It works on emulators and physical Android devices over adb. Check the device id before each call. github.com
A change can close the running app
SKILL.md says the system may terminate the app. Set permissions before launch or restart the app afterwards. github.com
Installing Argent changes your setup
The installation page says the init wizard installs @swmansion/argent globally, registers the MCP server in your editor and copies skills, rules and agent definitions into your workspace. The README says telemetry is opt-out (argent telemetry disable). Its proprietary simulator-server and ax-service binaries are licensed only for use within the project. github.com

Technical details

Scopes	iOS simulator permission store (TCC) Android permissions over adb

Questions

What does argent-settings-permissions do?

It teaches the assistant to grant, deny or reset one of 11 runtime permissions for an app on an iOS simulator or an Android device, using Argent's settings-permissions tool instead of the Settings app.

How do I install it?

Use the install box above and run the Argent init wizard first. The skill drives an Argent tool, so the skills CLI command on its own installs the instructions without the tool.

Does it work on a real iPhone?

No. SKILL.md says there is no host-side permission switch on a physical iPhone, so it works on iOS simulators only. On Android it works on emulators and physical devices over adb.

Does it need an API key?

SKILL.md names none. It needs Argent installed, a booted simulator or a connected Android device, and the app already installed on Android.

Is it safe to use?

It changes permission settings of the app and device you point it at, and SKILL.md warns that a change can terminate a running app. Use it on test simulators and emulators, and check the udid and bundle id before you run it.

When should I tap the dialog instead?

When the app has its own toggle or the system permission dialog is on screen. SKILL.md says that path exercises the real user flow and the tool is only for changes a person would make in system Settings.

Information

updated Nov 2, 2026

Repository: software-mansion/argent
Folder: packages/skills/skills/argent-settings-permissions

software-mansion/argent skills.sh

Sources

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

Show all 5

Argent installation docs · github.com
Argent supported editors · github.com
skills.sh listing · skills.sh
argent-settings-permissions SKILL.md · github.com
Argent README · github.com