diff --git a/src/hooks/gmail-ops.ts b/src/hooks/gmail-ops.ts
index dbf4d0f2e..4aae31ae3 100644
--- a/src/hooks/gmail-ops.ts
+++ b/src/hooks/gmail-ops.ts
@@ -114,6 +114,7 @@ export async function runGmailSetup(opts: GmailSetupOptions) {
     opts.project ??
     parsedTopic?.projectId ??
     (await resolveProjectIdFromGogCredentials());
+  // Gmail watch requires the Pub/Sub topic to live in the OAuth client project.
   if (!projectId) {
     throw new Error(
       "GCP project id required (use --project or ensure gog credentials are available)",
diff --git a/src/hooks/gmail-setup-utils.ts b/src/hooks/gmail-setup-utils.ts
index 5abe7bab1..d9d94d111 100644
--- a/src/hooks/gmail-setup-utils.ts
+++ b/src/hooks/gmail-setup-utils.ts
@@ -172,6 +172,7 @@ export async function ensureTailscaleEndpoint(params: {
   }
 
   const baseUrl = `https://${dnsName}${pathArg}`;
+  // Funnel/serve strips pathArg before proxying; keep it only in the public URL.
   return params.token ? `${baseUrl}?token=${params.token}` : baseUrl;
 }