From abd937ff08be135d8af09e808b78a7ee3a63cfda Mon Sep 17 00:00:00 2001
From: Daniel Roe <daniel@roe.dev>
Date: Wed, 26 Aug 2026 09:10:57 +0100
Subject: [PATCH] fix: clarify that 'act on your behalf' is misleading

---
 app/pages/connect.vue | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/app/pages/connect.vue b/app/pages/connect.vue
index c762d85..79c9a84 100644
--- a/app/pages/connect.vue
+++ b/app/pages/connect.vue
@@ -51,6 +51,13 @@ const accountLabel = login ?? 'your GitHub account'
           then you'll pick the tangled handle that mirrors it. we check this so
           nobody else can bind your repositories to their identity.
         </p>
+        <p class="connect__note">
+          GitHub's next screen always lists &ldquo;act on your behalf&rdquo; for any
+          app you authorize. synchub asks for no account permissions at all: we
+          make one request, for the list of installations you administer, to
+          check <strong>{{ accountLabel }}</strong> is one of them. the token is
+          discarded straight afterwards and never stored.
+        </p>
         <a class="btn btn--primary" :href="`/api/github/oauth/start?installationId=${installationId}`">
           verify with GitHub
         </a>
@@ -146,6 +153,15 @@ const accountLabel = login ?? 'your GitHub account'
   margin: 0 0 var(--space-lg);
 }
 
+.connect__note {
+  max-width: var(--measure);
+  margin: 0 0 var(--space-lg);
+  padding-left: var(--space-md);
+  border-left: var(--rule-hair) solid var(--color-rule);
+  color: var(--color-neutral);
+  font-size: var(--text-sm);
+}
+
 .signin {
   display: flex;
   flex-wrap: wrap;
-- 
2.51.2