feat(cli): add zero-friction Cloud quickstart
Closed
KH
2mo ago+683+683+012345678901234567890123456789-70-70-01234567890123456789
Summary
- make bare
npx relayfile@latesta clean-machine GitHub quickstart - perform the localhost Cloud browser login natively, without requiring
agent-relayon PATH - share the canonical
~/.agentworkforce/relay/cloud-auth.jsonsession and lock/refresh behavior - default the workspace to the current project and mount to
./relayfile-mount - print the absolute mount path and a ready-to-paste agent prompt
- update the CLI/product contract and hosted setup documentation
Cloud admission prerequisite: AgentWorkforce/cloud#3130. That PR must merge and deploy before this CLI version is published for fresh users.
Verification
npm run typechecknpm testscripts/check-contract-surface.shgo test ./cmd/relayfile-cli -run 'TestEnsureSetupCloudCredentials|TestQuickStart' -count=1\n- all-platform CLI binary build andnpm pack --workspace=packages/cli --dry-run\n- isolated-homenpm execfrom the packed tarball (relayfile --version=>0.10.46)\n-git diff --check\n\n## Security and compatibility\n- explicit/environment tokens retain precedence and are never silently replaced\n- callback state is random and constant-time validated\n- tokens are never printed and the canonical auth file remains atomic0600\n- legacyagent-relaysessions remain reusable\n\n## Review gate\nThe configured Veto MCP server returnednot readyon repeated attempts, so automatedveto_diff_reviewremains an explicit pre-merge gate. This PR does not deploy production.