Come usare
- Copia il comando e controlla il pacchetto prima di installarlo nel tuo ambiente agente.
- Controlla strumenti, credenziali e ambienti richiesti nel documento originale.
- Descrivi input e risultato desiderato; confronta l’output con le fonti.
npx skills add https://github.com/software-mansion/argent --skill argent-tv-interactPrima di iniziare
- L’installazione non include abbonamenti, quote API o accesso ai file.
- Stelle e installazioni indicano attività, non un test indipendente di qualità o sicurezza.
Contenuto dal repository con titoli, esempi, codice, tabelle, link e immagini preservati.
Argent TV (Apple TV + Android TV + Fire TV)
Critical
- A TV is focus-driven, not touch-driven. Drive every interaction with
describe+tv-remote+keyboard; never usegesture-*/ coordinate taps; they don't apply on any TV platform. - Always `describe` before navigating to find the live cursor and your target; never guess focus from a screenshot. The cursor is the focused element; on Vega the toolkit often leaves
focusedfalse and marks the highlighted item[selected], so treat[selected]as the cursor when nothing reports[focused]. - Pass the
udidfromlist-devices: an Apple TV simulator UDID or an Android TV / Vegaserial. Dispatch is automatic from the id; the same tools drive all three. - E2E tests: Vega only. Apple TV and Android TV have no e2e support (a
tap:can pass without doing anything): report that limitation. - Fire TV (Vega) (
platform: "vega"inlist-devices): readreferences/vega.mdbefore driving it. It covers booting and stopping the VVD, Fast Refresh, and debugging the JS runtime.
The navigation loop
describe: find the cursor and your target.tv-remote: move focus toward the target. Prefer one call with a path ending inselect, e.g.{button:["down","right","select"]}; count rows/columns from the list order.describeagain to confirm, or on Apple TVawait-ui-element {condition:"exists", selector:{text:"X", role:"focused"}}. On a miss, repeat.
Tools
describe, tv-remote and keyboard descriptions cover the TV behaviour (focus view, remote keys and paths, text-only typing). Beyond them:
launch-app/restart-app/reinstall-apptake thebundleIdfrom the app manifest.
Per-platform
Apple TV (tvOS simulator)
- Boot like any iOS sim (
boot-device); the firstdescribe/tv-remotestarts the AX + HID daemons (a few seconds). - Dev build:
open-url {udid, url:"<scheme>://expo-development-client/?url=http%3A%2F%2F<HOST_IP>%3A8081"}(<HOST_IP>= your Mac's LAN IP, shown on the launcher).
Android TV (leanback emulator)
- Boot the leanback AVD like any emulator; see
argent-android-emulator-setup. - Dev build:
open-url<scheme>://expo-development-client/?url=http%3A%2F%2F10.0.2.2%3A8081(<scheme>: the app's URL scheme, or its package name if it sets none), then dismiss the first dev menu withtv-remoteselect(notback: it exits the app).
Fast Refresh (dev builds)
Needs a Debug build + Metro running. argent only connects to Metro: start Metro yourself, and forward the port where the app needs it (Android: argent-metro-debugger §1; Vega: references/vega.md).
- Apple TV / Android TV: use the dev-build deep-links above;
npm startfor Metro. - Vega: see
references/vega.md.