When the first run fails

Four failures account for almost every first run that does not finish. Each one has a fix that takes under a minute, and none of them needs a support ticket.

Sign-in fails or loops back

The page says the attempt expired or was already used. Sign-in is rejected when it is more than ten minutes old, when the link has been followed once already, or when it comes back to a different browser than it started in. A bookmarked callback URL or a reloaded tab from an earlier attempt hits all three.

Start again at sign-in in one go, in the browser you started in, and let the page redirect on its own. If it fails on a clean attempt, write to hello@reachpad.dev.

This account has no fleet identity yet

The dashboard shows this instead of your workspaces, and the CLI refuses to create anything. Your account exists; the fleet identity it needs was registered in the background at sign-up and that step did not finish.

Open connect and press Set up this account. It registers the identity and the preview entitlement in a few seconds, changes nothing else, and is safe to press twice. Everything that was blocked works after it.

An agent in the workspace cannot call a model

Claude Code and Codex are installed in every workspace, and neither is signed in. Sign in to one inside the workspace with your own account, the way you do on a laptop. To have Reachpad make the model calls instead, add an Anthropic or OpenAI key on the Secrets page.

A key added there is brokered: Reachpad holds the value and spends it for your agents, and it never enters a workspace. Secrets and spend covers the ceiling that caps it.

The workspace will not start

The beta allows 10 workspaces, 5 running at once. A create or a start past that is refused, and the CLI exits 6. Nothing stops a running workspace on its own, so five left running yesterday are still running now.

$ reachpad list --state running$ reachpad pause <workspace-id>$ reachpad archive <workspace-id>   # once you are done with it

Pause frees a running slot and keeps the disk; archive frees a workspace slot and keeps the snapshots. If the balance rather than the count is the problem, reachpad auth whoami prints it, and plans and billing says how to top up.

This page as raw markdown, for an agent or a prompt: /docs/first-run.md