Setup won't finish — what to check

Updated about 2 months ago

Browse All

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

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 illustration
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 illustration
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 illustration
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.

Was this article helpful?

Built with supportpages.io — SaaS documentation software.

Have a question?

Search our articles, or ask and get an answer straight away.