> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lusor.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Fix common problems: a phone shows offline, an iPhone won't connect, a run failed or ran out of credits, or the agent is waiting on you.

## A phone shows Offline

On the **Phones** page, a phone that Lusor cannot reach shows **Offline**. What to check depends on the phone.

> [tab] Your own iPhone
>
> Your iPhone reaches Lusor through the Mac app. Check that:
>
> 1. The Mac is on, awake and online, and Lusor is open. Look for the Lusor icon in the menu bar.
> 2. The iPhone is unlocked. Automation pauses while it is locked.
> 3. The iPhone is on the same Wi-Fi network as the Mac, or connected with the USB cable.
>
> Then choose **Reconnect iPhone** in the Lusor menu bar menu.
>
> The phone's screen area tells you more:
>
> * **Waiting for your iPhone**: keep it unlocked and connected to your Mac, and open Lusor on your Mac.
> * **Paused in Lusor**: the iPhone was paused with **Pause iPhone**. Resume it in Lusor on your Mac.
> * **Couldn't start on your iPhone**: open Lusor on your Mac to see what needs fixing.
>
> The menu bar menu shows an **Attention** line with the reason when the iPhone needs something from you.

> [tab] Your own Android phone
>
> Your Android phone reaches Lusor through the Lusor Launcher app on the phone. Open it: it shows what it needs, such as turning **Lusor agent** back on in Accessibility. See [Connect your Android phone: Troubleshooting](https://docs.lusor.ai/help/connect-your-android.md#troubleshooting).

> [tab] Lusor Phone
>
> * **Setting up**: the phone is new or was just wiped. Wait a few minutes.
> * **Internet paused — out of credits**: your workspace can no longer pay for Lusor Internet. Your Lusor Phones stay offline until you add credits or turn on **Overages** in **Billing**. See [Plans and credits](https://docs.lusor.ai/help/plans-and-credits.md#overages).
> * **Phone removal in progress**: the phone has been marked for removal.
>
> If none of these apply and the phone stays offline, email [support@lusor.ai](mailto:support@lusor.ai) with the phone's Lusor ID from **Phone settings** → **General**.

## Your iPhone won't connect during setup

The Mac app's setup shows what went wrong and how to fix it. For every message and its fix, see [Connect your iPhone: Troubleshooting](https://docs.lusor.ai/help/connect-your-iphone.md#troubleshooting).

The most common causes are:

* Command Line Tools installed instead of full Xcode.
* The iPhone is locked, or did not trust the Mac.
* Developer Mode is off, or the iPhone was not restarted after turning it on.
* Xcode has no Apple ID signed in.

## A run failed or you are out of credits

> [accordion] This workspace is out of credits
>
> Your workspace has no credits left, so the agent cannot take the task. Upgrade your plan, or buy a credit pack in **Billing** → **Add credits**, then send your message again.
>
> A task that is already running can also stop part-way when its cost reaches the balance you had when it started. Add credits, then ask the agent to carry on.
>
> See [Plans and credits](https://docs.lusor.ai/help/plans-and-credits.md).

> [accordion] Out of Lusor Phone minutes
>
> When your workspace uses all its Lusor Phone minutes and **Overages** is off, agents cannot keep using your Lusor Phones. Turn on **Overages** in **Billing**, or upgrade your plan. Your own iPhone or Android phone does not use Lusor Phone minutes.

> [accordion] No phone attached
>
> The agent has no phone to use. Choose **Attach a phone** next to the chat and pick a phone. The waiting message runs once the agent has a phone.

> [accordion] The run shows Failed
>
> The agent could not finish. Open the replay to see where it stopped: hover over the reply and choose **Replay**. Check that the phone is online, then send the task again with clearer instructions.

## The agent is asking a question

Sometimes an agent needs you before it can continue. It waits, and the phone recording pauses until you answer.

* **A question:** the question appears in the chat and the message box changes to **Reply to agent**. Type your answer, or choose one of the suggested answers under the question.
* **A secret or a code**, such as a password or a sign-in code: a secure field appears with **Enter secret** or **Enter code**. Type the value and choose **Send**. The value is passed to the phone and is not shown in the chat. Secret requests can only be answered in the Lusor app.

If you do not want the agent to continue, choose **Stop**.

To answer the agent from your own code instead, see [Answer the agent](https://docs.lusor.ai/agents/answer-the-agent.md) in the Developers tab.

## Still stuck

Email [support@lusor.ai](mailto:support@lusor.ai), or choose **Contact support** in the app's account menu. Include the phone name and what you see on screen.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.