From 1008bb977fbbb7ea2df6eb4634497f2ac12a9577 Mon Sep 17 00:00:00 2001
From: l0ng-ai <24760907+l0ng-ai@users.noreply.github.com>
Date: Wed, 30 Sep 2026 17:14:14 +0800
Subject: [PATCH] ci: tell people how to install the phone app

The nightly release notes and each mobile-v release now say how to get
the app on a phone: the TestFlight link for iPhone, and the newest
mobile-v release's APK for Android. Both read .github/mobile-install.md.
---
 .github/mobile-install.md     | 6 ++++++
 .github/workflows/mobile.yml  | 2 +-
 .github/workflows/nightly.yml | 4 +++-
 3 files changed, 10 insertions(+), 2 deletions(-)
 create mode 100644 .github/mobile-install.md

diff --git a/.github/mobile-install.md b/.github/mobile-install.md
new file mode 100644
index 00000000..1a220848
--- /dev/null
+++ b/.github/mobile-install.md
@@ -0,0 +1,6 @@
+## Phone app
+
+Watch and drive this computer's panes and agents from your phone. On the computer, open **Settings → Mobile**, turn on **Allow phone access** and click **Show code**, then pair from the app by scanning the code or pasting it.
+
+- **iPhone**: join the beta at https://testflight.apple.com/join/gFcPbPVR. The link asks you to install TestFlight from the App Store first, if you don't have it.
+- **Android** (arm64): on the phone, download `tty7-<version>-android-arm64.apk` from the newest [`mobile-v*` release](https://github.com/l0ng-ai/tty7/releases?q=mobile-v&expanded=true) and open it. Android asks once to allow installing apps from your browser or file manager. A later APK installs over it and keeps your paired machines.
diff --git a/.github/workflows/mobile.yml b/.github/workflows/mobile.yml
index fd3ebba4..0ab4454d 100644
--- a/.github/workflows/mobile.yml
+++ b/.github/workflows/mobile.yml
@@ -135,6 +135,6 @@ jobs:
           else
             gh release create "$GITHUB_REF_NAME" --repo "$GITHUB_REPOSITORY" \
               --draft --latest=false --title "tty7 mobile $VERSION" \
-              --notes "Android: download the APK below on the phone and open it. Android asks once to allow installing apps from your browser or file manager. A later APK installs over this one and keeps your paired machines."
+              --notes-file .github/mobile-install.md
           fi
           gh release upload "$GITHUB_REF_NAME" dist/* --clobber --repo "$GITHUB_REPOSITORY"
diff --git a/.github/workflows/nightly.yml b/.github/workflows/nightly.yml
index e3243a9b..341d973c 100644
--- a/.github/workflows/nightly.yml
+++ b/.github/workflows/nightly.yml
@@ -546,7 +546,9 @@ jobs:
           git push -f origin "$GITHUB_SHA:refs/tags/nightly"
 
           TITLE="Nightly $VERSION"
-          NOTES="Automated nightly build of \`main\` @ ${GITHUB_SHA::7} ($(date -u +%F)). Rolling prerelease — assets are replaced every night; for the latest stable release see https://github.com/${GITHUB_REPOSITORY}/releases/latest."
+          NOTES="Automated nightly build of \`main\` @ ${GITHUB_SHA::7} ($(date -u +%F)). Rolling prerelease — assets are replaced every night; for the latest stable release see https://github.com/${GITHUB_REPOSITORY}/releases/latest.
+
+          $(cat .github/mobile-install.md)"
 
           if gh release view nightly >/dev/null 2>&1; then
             gh release edit nightly --prerelease --title "$TITLE" --notes "$NOTES"