A setup that looks stuck is usually doing one of two things: quietly downloading the browser it uses for screenshots, or waiting for an answer from you. A quick check tells you which one it is — and clears it. ## What Setup needs - Git installed and available in your terminal. - Claude Code or Codex installed, so its command runs here. - A normal terminal window you can type in — Setup's questions need one. ## Checks and fixes ### Check 1: Give the browser download time to finish On its first run, Setup offers to download the browser it uses to take screenshots. That download is the one slow step — a few minutes is normal. Accept the download and leave the window open; Setup keeps printing as it works. ![Give the browser download time to finish](https://help.wtfm.sh/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MTI2MTYsInB1ciI6ImJsb2JfaWQifX0=--ac85c62f00ae82a791983f02fb541c441e4791c5/block_wait-for-download.png) ### Check 2: Approve the sign-in in your browser If you chose to sign in, Setup opens your browser and shows a short code. Approve the sign-in there, then come back to the terminal — it is only waiting on that browser step. ![Approve the sign-in in your browser](https://help.wtfm.sh/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MTI2MTcsInB1ciI6ImJsb2JfaWQifX0=--63c6c59d69ecf0cdec069633aa1edf085eef1fda/block_approve-signin.png) ### Check 3: Run the readiness check Still not finishing? `wtfm doctor` lists everything Setup needs and flags anything that is missing. Run it and look for a line that starts with **Missing**. ![Run the readiness check](https://help.wtfm.sh/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6MTI2MTksInB1ciI6ImJsb2JfaWQifX0=--d87608a39cde71f424f6b18546a9a7129ba2008d/block_run-doctor.png) ### Check 4: Install what doctor reports missing If Git is missing, install it with your system package manager. If your coding agent isn't found, install Claude Code or Codex and make sure its command runs in this terminal. Then run Setup again — it keeps anything that already finished. ## Tips - `wtfm doctor` is the quickest way to see what Setup still needs. - Setup keeps completed steps, so running `wtfm setup` again picks up where it stopped. - Interactive questions don't work in a background or non-interactive shell — run Setup in a normal terminal window. ## Summary Most setups that look frozen are just the first browser download or a question waiting on your answer. When something really is missing, `wtfm doctor` names it — install it and run `wtfm setup` again.