argent-tv-interact skill: control Apple TV, Android TV and Fire TV apps with your agent

Teaches your agent to control TV apps on Apple TV, Android TV and Fire TV through Argent, using a remote instead of taps.

Installs: 22.5K; on skills.sh
Stars: 3.1K; on GitHub
Updated: Oct 2026; last repo commit

argent-tv-interact tells your agent how to drive a TV app through Argent. It boots the simulator or emulator, reads which element has focus, moves with the D-pad remote, types text and takes screenshots. On Fire TV (Vega) it can also evaluate JavaScript and read console and network logs.

The skill uses Argent's own tools, not shell commands of its own, so it works only with Argent set up. It triggers when a task targets a TV (runtimeKind "tv" or platform "vega") or mentions Apple TV, tvOS, Android TV, leanback, Vega, Fire TV or VVD. A TV is focus-driven, so the skill forbids touch gestures and coordinate taps.

Good for

React Native developers testing apps on Apple TV, Android TV or Fire TV
QA engineers reproducing focus and navigation bugs on TV
Fire TV (Vega) developers who need JS console logs and network traces

Install argent-tv-interact

Claude Code

Copy this prompt.

Install the argent-tv-interact skill in Claude Code. Run this command:

npx @swmansion/argent@latest init

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js 20.12 or newer.

argent-tv-interact calls Argent's own tools (describe, tv-remote, keyboard), so the skill is useless without the Argent MCP server. The wizard installs both. For Apple TV you need macOS with Xcode, for Android TV adb and an AVD, for Fire TV the Vega SDK.

From the vendor's docs. Source.

What's in the skill

When it loads

Control and inspect TV apps via argent, Apple TV (tvOS), Android TV (leanback), and Amazon Fire TV (Vega). Boot the target, read focus, navigate with the D-pad remote, type, screenshot, and on Vega debug the JS runtime (evaluate, console logs, network inspector). Use when a task targets a TV (runtimeKind "tv", or platform "vega"), or mentions Apple TV / tvOS / Android TV / leanback / Vega / Fire TV / VVD.

Sections in SKILL.md

Critical
The navigation loop
Tools
Per-platform
Apple TV (tvOS simulator)
Android TV (leanback emulator)
Fire TV (Vega / VVD)
Common gotchas
Fast Refresh (dev builds)
Debugging the JS runtime (Vega)

Key facts

Author: Software Mansion (Argent)
Repository: software-mansion/argent (packages/skills/skills/argent-tv-interact)
Installs on skills.sh: 22,484 as of 2026-11-02
GitHub stars: 3,138 for the whole software-mansion/argent repo, 2026-11-02
License: Apache-2.0 (as detected by GitHub)
Last commit to the repo: 2026-10-31
What is inside: 1 file (SKILL.md only), part of the Argent package

What it includes

Shows the focused element and everything focusable
Returns the cursor and the focusable elements with labels. Always called before and after moving. On Vega a highlighted item is marked [selected].
Read · describe
D-pad and remote keys, or a whole path in one call
Keys include up, down, left, right, select, back, menu, home and playPause, plus media keys. A path such as down, right, select runs in one call.
Try: “On the Apple TV simulator, open the Settings row and select Sign out.”
Runs code · tv-remote
Types text into the focused field
Focus the field with tv-remote first. Named key presses such as enter work on Vega.
Runs code · keyboard
Start, restart or reinstall an app by bundle id
On Vega, reinstall-app takes the path to a .vpkg file.
Runs code · launch-app, restart-app, reinstall-app
Captures the TV screen
Apple TV uses xcrun simctl; Android TV and Vega capture from the host through adb or screencap.
Runs code · screenshot
Apple TV, Android TV and Fire TV (Vega) setup and quirks
Covers booting, dev builds, empty focus trees and developer mode on the Vega virtual device.
Runs code · Per-platform notes
debugger-evaluate, console logs and network inspector
With a Debug build and Metro running, debugger-connect, debugger-status, debugger-evaluate, debugger-log-registry, view-network-logs and view-network-request-details work on a Vega virtual device.
Runs code · Vega JS runtime debugging

From the official docs

Permissions

Medium risk

The skill makes your agent control emulators and apps through the Argent package, which you install separately. Use test builds and decide on telemetry before you accept the wizard.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It needs the full Argent package installed
The wizard installs @swmansion/argent globally, registers an MCP server in your editor and copies skills into your workspace. Review the prompts before you accept.
It can run code inside a Vega app
debugger-evaluate runs JavaScript in the app runtime. Use it on test builds, not production devices with real accounts.
Argent sends opt-out telemetry
Turn it off with argent telemetry disable or DO_NOT_TRACK=1 if you do not want usage data sent.

Technical details

Talks to	Argent telemetry (opt-out) per its docs. Metro on localhost:8081 for dev builds
Scopes	Boots and controls Apple TV simulators, Android TV emulators and Fire TV virtual devices Launches, restarts and reinstalls apps by bundle id Takes screenshots through xcrun simctl, adb or screencap On Vega, evaluates JavaScript and reads console and network logs

Questions

What does argent-tv-interact do?

It tells your agent how to control TV apps through Argent. The agent can boot an Apple TV, Android TV or Fire TV target, read focus, press remote keys, type, and take screenshots.

Does it work without Argent?

No. The skill calls Argent tools such as describe and tv-remote. Argent's docs say npx @swmansion/argent@latest init installs the package, registers the MCP server in your editor and copies the skills into your workspace.

How do I install it in Claude Code or Codex?

Use the install box at the top of this page, which runs the Argent setup wizard. Argent's docs list Claude Code, Cursor, Codex CLI and other editors as ones the wizard configures. A Claude app upload is not offered because the skill needs the Argent tools running on your machine.

What do I need on my machine?

Node.js 20.12 or newer. Apple TV needs macOS with Xcode. Android TV needs the Android SDK Platform Tools (adb) and an emulator. Fire TV needs the Vega SDK and adb.

Does it collect usage data?

Argent itself collects opt-out telemetry, per its docs. Turn it off with argent telemetry disable, or set DO_NOT_TRACK=1.

Can I use touch gestures or taps?

No. The SKILL.md says a TV is focus-driven and tells the agent never to use gesture tools or coordinate taps. It drives everything with describe, tv-remote and keyboard.

Is it safe to install?

The skill makes your agent run emulators, install and restart apps and capture screens on your machine. Use test builds and test accounts. The Argent setup also installs a package globally and registers an MCP server, so read the wizard's prompts before you accept.

Information

updated Nov 2, 2026

Repository: software-mansion/argent
Folder: packages/skills/skills/argent-tv-interact

software-mansion/argent skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 5

Argent installation docs · github.com
Argent supported editors · github.com
argent README · github.com
argent-tv-interact SKILL.md · github.com
Argent telemetry docs · github.com