argent-tv-interact

Installation
SKILL.md

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 use gesture-* / 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 focused false and marks the highlighted item [selected], so treat [selected] as the cursor when nothing reports [focused].
  • Pass the udid from list-devices: an Apple TV simulator UDID or an Android TV / Vega serial. 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" in list-devices): read references/vega.md before driving it. It covers booting and stopping the VVD, Fast Refresh, and debugging the JS runtime.

The navigation loop

  1. describe: find the cursor and your target.
  2. tv-remote: move focus toward the target. Prefer one call with a path ending in select, e.g. {button:["down","right","select"]}; count rows/columns from the list order.
  3. describe again to confirm, or on Apple TV await-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:

Installs
26.8K
GitHub Stars
3.2K
First Seen
Jul 1, 2026