#238 Visitor journey fixes: /download page, one login, tagged signup CTAs, signup recovery

Visitor journey fixes across the marketing site and the arelay.to router.

Desktop download

• /download leads with the build for the visitor's OS and architecture: the DMG on macOS (Apple silicon unless Client Hints report x86), the .deb on Linux, and Setup.exe on Windows (x64 unless Client Hints report Arm). One alternate sits beside it. A visitor whose OS can't be detected gets macOS, Linux and Windows side by side.
• It lists every latest-release build (macOS DMGs, Linux .deb and .tar.gz, Windows Setup and portable zip) with its .sha256, the requirements (macOS 13+; Linux glibc 2.34+, GTK 4.6+, systemd for the background service; Windows per-user install with a logon task), and "Let your agent install it" pointing to /signup/teams.
• The page is linked from the footer ("Desktop app"), the homepage closing line "Install the desktop app…", and the Relayhistory MCP docs. It is in the sitemap.
• lib/desktop-downloads.ts holds the release URL and asset list. The agent signup guide uses the same constant.
• Router: download is a reserved handle, and arelay.to/download (and www.) redirects to https://agentrelay.com/download.

Sign-in and signup

• Every "Log in" goes to the site's /login.
• teamsGoogleAuthHref(placement) is the one Teams Google sign-up URL builder. It tags each CTA with utm_content (home_hero, home_nav, home_hosting, home_final_cta, teams_hero, teams_nav, signup_band, pear), the way Flows does.
• $pageview is captured on /, /login, /signup/* and /download.
• The homepage "Agent first, easy install" card links to /signup/teams and says "About 10 minutes", matching the final CTA.

Agent signup journey

• The Teams idle hint reads "Paste into a coding agent on your Mac or Linux machine."
• Failed and expired sessions show "Start a new session" as the primary button, in view. The restart in Setup details stays.
• Back returns to the same-origin page that linked here, falling back to /<product>.
• Step 4 copy says only the sessions you choose are shared. /teams says the same.

Agents directory

• Agent pages offer "Fork on GitHub" only. The /cloud/deploy?persona=… launch link, launchUrl/personaUrl/personaFile, and the "one click" copy are gone.

Vendored skills and cleanup

• writing-relayflows is pinned at 1.6.4 through prpm (installed with CI's prpm 2.1.40; a frozen install leaves the tree clean). It now ships scripts/, so prpm records it by directory. generate-setup-skills.mjs resolves a directory installedPath to its SKILL.md. Sessions stays at 0.3.0, the version on AgentWorkforce/skills main.
• The undeployable /install.sh probe installer is removed, along with its test, scripts/stage-probe.mjs, its gitignore entry and the Connect guide's warning about it. The web/waitlist.json ignore and the retired-origin comment in /pear/download are gone too.

Verification

• npm test (web 639 passed, router 111 passed), tsc --noEmit in web and router, and verify:setup-skills.
• A production build, served on its own port, passes e2e/agent-signup.spec.ts (6) and e2e/pages.spec.ts for /, /download, /login, /teams, /pear, /support and /agents*.

🤖 Generated with Claude Code

---

^{Need help on this PR? Tag @codesmith-bot with what you need.}

---

Summary by cubic

Fixes the visitor journey across the marketing site: a new desktop download page, unified sign-in and signup links, and recovery when an agent setup fails.

Desktop download

• /download leads with the build for the visitor's OS and architecture (DMG on macOS, .deb on Linux, Setup on Windows) and falls back to all three platforms when detection fails.
• The page lists every latest-release build with its SHA-256 and requirements, and is linked from the footer, homepage, MCP docs, and sitemap; arelay.to/download redirects to agentrelay.com/download.
• Release URLs live in web/lib/desktop-downloads.ts, shared by the agent signup prompt.

Sign-in, signup, and cleanup

• All "Log in" links point to /login, Teams signup CTAs are built by one helper that tags each with utm_content, and $pageview fires on /, /login, /signup/*, and /download.
• Failed and expired signup sessions show a visible "Start a new session", and Back returns to the same-origin page that linked in.
• The setup guide's step 4 and /teams say new sessions are shared automatically.
• Agent and use-case pages invite forking a gallery agent only; the one-click cloud deploy link and the probe installer (/install.sh) are removed.
• writing-relayflows is pinned at 1.6.4, and skill generation now resolves multi-file skills.

---

Agent Relay sessions

• claude session 34797b78 · opened via gh pr create · last active 2026-10-23