使い方
- インストールコマンドをコピーし、自分の環境へ導入する前にソースを確認します。
- 必要なツール、認証情報、対応環境を原文で確認します。
- 入力と成果物を指定し、出力を資料と照合します。
npx skills add https://github.com/software-mansion/argent --skill argent-screen-recording開始前の確認
- 導入にはモデル契約、API枠、ファイルへのアクセス許可は含まれません。
- スター数や導入数は活動の指標であり、独立した品質・安全性試験ではありません。
見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。
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.