Install an Apple TV App

Establish inputs

1. Obtain the source-project path or existing IPA path.
2. Obtain the atvloadly URL from the user or ATVLOADLY_URL. Ask if neither is available; never hardcode a private host or IP.
3. Confirm who controls the atvloadly host. Prefer HTTPS for a public URL; use HTTP only on a user-confirmed trusted LAN. Reject URLs containing credentials.
4. Obtain the exact Apple TV name. Never select the first device or an ambiguous device.
5. Keep all Apple credentials out of commands, files, logs, screenshots, and responses.

Prepare the IPA

For a source project:

1. Read its AGENTS.md, README, build documentation, project files, and CI configuration before running commands.
2. Inspect git status; preserve every existing modification and untracked file.
3. Confirm a tvOS target, Bundle Identifier, minimum tvOS version, supported architecture, dependencies, and signing requirements.
4. Install dependencies and build using the project's documented method. Prefer a Release archive/export when the project supports it.
5. Run the project's relevant tests and build checks. Fix root causes; never delete functionality or skip required checks to manufacture success.
6. Locate the resulting .ipa and retain its absolute path.

For an existing IPA, skip the build and begin with validation.

Run read-only preflight

Run the bundled script from this skill directory:

python3 <skill-directory>/scripts/preflight.py \
  --base-url "${ATVLOADLY_URL:-<user-provided-url>}" \
  --device-name "<exact-Apple-TV-name>" \
  --ipa "<absolute-path-to-ipa>" \
  --json

Require all checks to pass. Record the atvloadly version, service status, selected paired Apple TV ID, RPPairing connection, IP, port, IPA app name, Bundle Identifier, minimum tvOS version, size, and SHA-256. The script performs GET requests only and never uploads or changes state.

Install through the web UI

1. Use chrome-use exclusively for the live web UI. If unavailable, follow its self-heal instructions; do not switch to another browser tool.
2. Load the current browser workflow with chrome-use skills get core --full.
3. Open the resolved atvloadly URL.
4. Take a fresh snapshot before every interaction. Use only refs from the latest snapshot; never reuse stale refs or guess selectors.
5. Select the exact paired Apple TV verified by preflight.
6. Open its install page and choose the validated IPA.
7. Before starting installation, re-check the visible device name and the IPA path/name against the preflight Bundle Identifier and SHA-256.
8. Stop for the user to handle Apple ID selection, password entry, 2FA, or developer-account choice. Never request credentials in chat, type them, read them, or expose them in command output.
9. Resume with a fresh snapshot after the user confirms completion, then start or continue installation.
10. Capture the terminal installation result and relevant logs without secrets.

Verify completion

Treat these as separate evidence layers:

• Build: tests/checks passed and the tvOS IPA was produced.
• Upload: atvloadly accepted the validated IPA.
• Install: atvloadly reported installation completion for the exact paired device.
• Physical device: the app icon appeared on that Apple TV, launched successfully, rendered its first screen, and passed a minimal core-function smoke test.

Do not claim physical-device success from an HTTP response, browser page, upload result, or install log alone. Ask the user to perform or confirm the on-TV steps when remote observation is unavailable. Report incomplete and failed layers explicitly.