How to use
- Copy the installation command and review the source package before installing it in your own agent environment.
- Check the source document for required tools, credentials and supported hosts.
- Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/software-mansion/argent --skill argent-tv-interactBefore you start
- Installation does not include a model subscription, API allowance or permission to access your files.
- Repository stars and installation counts describe activity, not an independent quality or security test.
Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.
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.