software-mansion/argent

argent-tv-interact

Control and inspect TV apps via argent, Apple TV (tvOS), Android TV (leanback), and Amazon Fire TV (Vega).

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/software-mansion/argent --skill argent-tv-interact

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

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:

  • launch-app / restart-app / reinstall-app take the bundleId from the app manifest.

Per-platform

Apple TV (tvOS simulator)

  • Boot like any iOS sim (boot-device); the first describe / tv-remote starts 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 with tv-remote select (not back: 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 start for Metro.
  • Vega: see references/vega.md.
같은 저장소의 Skills

더 많은 Skills

모든 Skills
software-mansion
커뮤니티

argent-android-emulator-setup

Set up and connect to an Android emulator using argent MCP tools. Use when starting a new session on Android, booting an emulator, getting a device serial, or before any UI interaction task.

1시간 설치 수
6
GitHub Stars
3.2천
업데이트
11월 19일
software-mansion
커뮤니티

argent-create-e2e

Create, record, edit, replay, or repair reusable Argent e2e test YAML files. Use when the user asks to record, replay, or run an e2e test or a repeatable device path, set up profiling or an A/B comparison, or invoke the authoring engine behind argent-qa-e2e. Also use before repeating three or more interactions. For one-off UI checks, acceptance-driven regression tests, or screen video, use argent-test-ui-flow, argent-qa-e2e, or argent-screen-recording respectively.

1시간 설치 수
6
GitHub Stars
3.2천
업데이트
11월 19일
software-mansion
커뮤니티

argent-device-interact

Interact with an iOS simulator or iPhone, Android emulator or phone, or Chromium (CDP) app using argent MCP tools. Use when tapping UI elements, performing gestures, scrolling/swiping, typing text, pressing hardware buttons, launching apps, opening URLs, taking screenshots, waiting for an element to appear or disappear, or checking visible app state after interactions. Not for TV targets.

1시간 설치 수
6
GitHub Stars
3.2천
업데이트
11월 19일
software-mansion
커뮤니티

argent-ios-device-interact

Drive a physical iPhone through argent. Use when a physical iPhone is involved (a list-devices iOS entry with kind "device") and ONLY then; never for a simulator. For cable, trust, or signing problems read argent-ios-device-setup.

1시간 설치 수
6
GitHub Stars
3.2천
업데이트
11월 19일