argent-tv-interact

Control and inspect Apple TV, Android TV, and Fire TV apps via focus-driven remote automation.

Updated Aug 29, 2026
One-click install
npx skills add https://github.com/Seyamalam/pstu_final --skill argent-tv-interact-seyamalam
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: argent-tv-interact
Source: https://github.com/Seyamalam/pstu_final/tree/main/.agents/skills/argent-tv-interact
Command: npx skills add https://github.com/Seyamalam/pstu_final --skill argent-tv-interact-seyamalam

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? TV apps are focus-driven rather than touch-driven, so standard tap-and-gesture automation fails on tvOS, Android TV, and Fire TV (Vega). This Skill provides a reliable describe-then-navigate loop using D-pad remote commands, keyboard input, and screenshots to drive and debug TV apps across all three platforms. ## Core Features & Use Cases - Focus-driven navigation: Use describe to read the focused element and focusable tree, then move with tv-remote D-pad paths like {button:["down","right","select"]}. - Cross-platform dispatch: One toolset drives Apple TV simulators, Android TV leanback emulators, and Vega VVDs, dispatched automatically from the device udid or serial. - Vega JS debugging: Evaluate JS, read console logs, and inspect network traffic on Fire TV via the Hermes debugger once a Debug build and Metro port-forwarding are set up. - Use Case: A QA engineer testing a react-native-tvos app boots an Android TV emulator, describes the home screen to locate a tile, sends a D-pad path to select it, and screenshots the result to confirm navigation. ## Quick Start Ask the assistant to list TV devices, describe the current screen focus, and navigate to a target tile using the TV remote on your Apple TV, Android TV, or Fire TV device.

Frequently Asked Questions about argent-tv-interact

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate navigation on an Apple TV or Android TV app?

TV automation uses a describe-then-navigate loop: call describe to find the focused element and focusable targets, then send a tv-remote D-pad path like {button:["down","right","select"]} to move focus and select. Coordinate taps and gestures do not work on any TV platform.

How do I debug the JavaScript runtime on Amazon Fire TV (Vega)?

Install a Debug .vpkg build, start Metro, run vega device start-port-forwarding --port 8081, then launch the app. The debugger-evaluate, debugger-log-registry, and network inspection tools then work over the legacy Hermes inspector.

Why does describe return an empty focus tree on Android TV?

Many react-native-tvos screens use React Native's own focus engine, which is invisible to the OS accessibility tree. Describe falls back to the full UI tree; tv-remote still moves focus, so navigate blind and confirm with screenshots.

Can I use tap gestures or coordinates to control a TV app?

No. TVs are focus-driven, not touch-driven, so gesture and coordinate-tap tools do not apply on tvOS, Android TV, or Vega. All interaction must go through describe, tv-remote D-pad keys, and keyboard input.

Why is my Vega app not reflecting code changes after editing node_modules?

Editing node_modules has no effect on Release builds because only Debug .vpkg builds load patchable JavaScript. Rebuild a Debug package, reinstall it, and ensure Metro with port-forwarding is running for Fast Refresh.