Argent Tv Interact

When you need to automate TV apps across Apple TV, Android TV, or Fire TV, this gives Claude the tools to drive them like a remote control. It handles focus-based navigation (the core difference from mobile), screenshots, keyboard input, and on Fire TV you get full JS runtime debugging through the Hermes inspector. The critical insight here is that TVs are focus-driven, not touch-driven, so you work in a loop of describe, remote button presses, and verify. Works with simulators and emulators plus Fire TV's VVD virtual devices. If you're testing a leanback UI or debugging why your app behaves differently on a 10-foot interface, this is the skill that makes Claude useful instead of guessing at screenshots.

skills.sh installs: 24.5K
GitHub stars: 3.2K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add software-mansion/argent --skill argent-tv-interact --agent claude-code

Installs into .claude/skills of the current project.

Files

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.