software-mansion/argent

argent-settings-permissions

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…

Quelltext ansehen

Verwendung

  1. Installationsbefehl kopieren und das Quellpaket vor der Installation in der eigenen Agentenumgebung prüfen.
  2. Benötigte Werkzeuge, Zugangsdaten und Hosts im Original prüfen.
  3. Eingabe und gewünschtes Ergebnis beschreiben und die Ausgabe mit den Quellen abgleichen.
npx skills add https://github.com/software-mansion/argent --skill argent-settings-permissions

Vor dem Start

  • Die Installation umfasst weder Modellabo noch API-Kontingent oder Dateizugriffsrechte.
  • Sterne und Installationen zeigen Aktivität, keine unabhängige Qualitäts- oder Sicherheitsprüfung.
Originales Skill-Dokument

Aus dem Quell-Repository gerendert; Überschriften, Beispiele, Code, Tabellen, Links und Bilder bleiben erhalten.

settings-permissions edits the platform's permission store directly (the iOS simulator's TCC database, Android's runtime permissions over adb). It is a test-setup / out-of-band tool, not a general permissions toggle: the default way to change a permission is still through the app. The tool's description covers the supported permissions per platform, the parameters, the result (applied / skipped) and the per-platform requirements.

When to use it - and when NOT to

The first matching row wins.

SituationDo this
The app has an in-app control for the permission (a toggle in its own settings screen)Tap it in the app (describe → gesture-tap); it exercises the flow you're testing
The app asked and the system permission dialog is on screenTap the dialog (Allow / Don't Allow / Allow While Using App); describe exposes its buttons
The permission must be granted/denied before the app runs, so no dialog interrupts the flowUse this tool (grant / deny) before launch-app
The user already denied it and you need it on againUse this tool (grant): iOS never re-shows a dialog once denied
You need the first-run dialog to appear againUse this tool (reset)
The permission is unsupported on the target platform, or it isn't one of the 11 runtime permissions (Wi-Fi, dark mode, VPN, Focus, …)Do NOT use this tool: answer the app's dialog, or drive the Settings app or the app's own UI

Rule of thumb: if a human tester could flip it inside the app, do that. Reach for settings-permissions only for a change a human would otherwise make in the system Settings app.

Gotchas

  • iOS simulator only on Apple platforms. A physical iPhone has no host-side TCC switch, so the tool does not apply there.
  • A pre-launch `deny` suppresses the prompt on iOS only. On iOS a TCC denial answers the app's request, so no dialog appears. On Android a deny clears the grant but sets no "user-fixed" flag, so the app's next request still shows the system dialog: a pre-launch deny there tests the revoked state, not a suppressed prompt.
  • Android `reset` below API 33 can't clear "don't ask again". It revokes the grant, but clearing the user-fixed flag needs Android 13 / API 33+, so the dialog may stay suppressed on older devices.
  • Set permissions before `launch-app`. A change can terminate a running app; if you change one while it runs, restart-app afterwards.
  • Android `location-always`: a grant also adds fine and coarse location, since background alone can't read location.
aus demselben Repository

Weitere Skills

Alle Skills
software-mansion
Community

argent-android-emulator-setup

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.

Installationen / 1h
6
GitHub Stars
3211
Aktualisiert
19. Nov.
software-mansion
Community

argent-create-e2e

Create, record, edit, replay, or repair reusable Argent e2e test YAML files. Use when the user asks to record, replay, or run an e2e test or a repeatable device path, set up profiling or an A/B comparison, or invoke the authoring engine behind argent-qa-e2e. Also use before repeating three or more interactions. For one-off UI checks, acceptance-driven regression tests, or screen video, use argent-test-ui-flow, argent-qa-e2e, or argent-screen-recording respectively.

Installationen / 1h
6
GitHub Stars
3211
Aktualisiert
19. Nov.
software-mansion
Community

argent-device-interact

Interact with an iOS simulator or iPhone, Android emulator or phone, 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.

Installationen / 1h
6
GitHub Stars
3211
Aktualisiert
19. Nov.
software-mansion
Community

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.

Installationen / 1h
6
GitHub Stars
3211
Aktualisiert
19. Nov.