Mode d’emploi
- Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
- Consultez le document original pour les outils, identifiants et environnements requis.
- Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/software-mansion/argent --skill argent-screen-recordingAvant de commencer
- L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
- Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.
screen-recording-start and screen-recording-stop carry the options (timeLimitSeconds, trimStatic, showTouches) and the result fields. One recording per device at a time; different devices can record concurrently.
1. Critical: never leave a recording running
A forgotten recording keeps capturing until its timeLimitSeconds cap fires, holding the session and delaying the video. Use both safety nets:
- Set yourself a reminder the moment the recording starts, for the expected end of the interaction. Use whatever your harness provides: a reminder/wakeup or scheduled-task tool if you have one, otherwise a background shell running
sleep <expected-seconds>whose completion notification pulls you back. When it fires, callscreen-recording-stop. Do not rely on remembering. - Read the tool-result notes. While a recording runs, every argent tool result carries a
NOTE:about it. If the note says the recording already ended, still callscreen-recording-stop: that is what hands you the file.
2. Workflow
- Get the device booted and the app into the state the video should open on (
list-devices,launch-app,argent-device-interact). - Call
screen-recording-startwithudidand atimeLimitSecondsslightly above the expected interaction length. - Set the end-of-recording reminder from §1; this step is not optional.
- Drive the interaction (
argent-device-interact). Preferrun-sequencefor tight multi-step interactions so tool-call latency does not pad the video. - Call
screen-recording-stopwith the sameudid. Checkwarning(cap-triggered stop, early encoder exit, dropped frame stream, possibly truncated file) and confirm the file has a sane size before presenting it.
Where the file lands. A finished recording is saved durably on the client, even with a remote argent link tool-server: into <project>/.argent/recordings/ (the nearest ancestor of the client's working directory with a .git/package.json/.argent), or ~/.argent/recordings/ outside a project. Change it with argent config set recordings.directory <dir> (--scope project for a per-repo choice). Mention the path to the user, and that the file is untracked: add it to .gitignore or clean it up if it shouldn't be committed.
3. Platform notes and limits
- Recordable: iOS simulators (local and remote
remote:), Android emulators and physical Android devices. Unsupported: physical iPhones, tvOS simulators, Chromium apps, Vega/Fire TV and HarmonyOS. For a still frame usescreenshot; for a replayable interaction script useargent-create-e2e. - One size per video: the video keeps the size of the screen at the start; a later size change is letterboxed. On a foldable simulator, start recording on the panel you need at full size.
- Remote (`remote:`) simulators: the video keeps the screen's portrait orientation, so a device in landscape plays sideways.
- Android: secure screens (DRM, some password fields) come out black.
- Watermark: a faint Argent logo is stamped bottom-left. Turn it off with
argent disable video-watermark; the flag is read when a recording starts.