Steam Frame from a Mac: research docs and helper scripts

README with the minimum-typing checklist (Developer Mode toggle + Set User
Password; the rest runs from the Mac), docs for SSH, streaming, file
transfer, and open questions with sourced confidence levels, plus Mac-side
zsh helpers and a fallback headset bootstrap.

Scripts are UNTESTED against hardware: checked with zsh -n / bash -n /
shellcheck only. Two SWE-2 Max read-only review passes (devin -p --model
swe-2-max); verified findings fixed.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>

scripts/push.sh

@@ -0,0 +1,18 @@
+#!/usr/bin/env zsh
+# Mac-side: copy a file or folder to the Steam Frame.
+#
+# UNTESTED against real hardware.
+#
+# Usage: scripts/push.sh SOURCE [REMOTE_DEST]   (default dest: ~/Downloads/)
+set -euo pipefail
+
+FRAME_ALIAS=${FRAME_ALIAS:-frame}
+src=${1:?usage: push.sh SOURCE [REMOTE_DEST]}
+dest=${2:-Downloads/}
+
+if ssh "$FRAME_ALIAS" 'command -v rsync >/dev/null'; then
+  rsync -a --progress "$src" "$FRAME_ALIAS:${(q)dest}"  # remote shell parses the path
+else
+  print -u2 "rsync not found on the Frame; falling back to scp"
+  scp -r "$src" "$FRAME_ALIAS:$dest"  # modern scp uses SFTP: no remote shell parsing
+fi