# Troubleshooting (https://getreely.co/docs/troubleshooting)

> Fixes for the common Reely problems: the agent cannot find Reely, a run hangs, the Simulator misbehaves, or the video is missing a screen.

The handful of things that actually go wrong, and what each one means.

## The agent does not seem to know about Reely

It was never connected, or it was connected for a different project. Open Reely, use **Set up agents**, and pick **Install Globally** so every project is covered. Then restart the agent so it picks up the new tools.

## The first run takes forever

A cold build of an iOS project takes minutes, and some agents give up waiting before it finishes. The work keeps going — ask again and the second attempt reuses the build. If your agent times out repeatedly, raise its tool timeout.

## Recording produces a frozen or black video

Usually a wedged Simulator from an earlier session. Quit the Simulator entirely and run again. Closing other Simulator windows before a recording also avoids a stuck recorder.

## A screen never appears in the video

A screen change was collapsed into one step — most often an interstitial sheet, or two swipes treated as one. Name the missing screen explicitly and ask for it to be its own beat. See [The flow](https://getreely.co/docs/directing/flow).

## A tap lands on a dead button

The button was disabled because a required field was not filled yet. Ask for every field to be filled before its submit step.

## The screens do not look like my app

Give screenshots and ask to see the rebuilt screens before recording. That single review catches almost every fidelity problem — see [Accuracy](https://getreely.co/docs/directing/accuracy).

## Export is refused

That is the license gate. Everything you made is safe and exports once you subscribe — see [Plans](https://getreely.co/docs/plans).

## Something else

Tell your agent what you saw and what you expected. It has the run output and can usually diagnose it faster than you can reproduce it.