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

# Appeeky Desktop

> Watch a connected phone live, control it by hand and give tasks to the phone agent from the Phone page.

Appeeky Desktop has two places for phones:

* **Settings → Phones** turns sharing with Appeeky on and off. See [Connect phones](https://docs.appeeky.com/docs/phones/connect-phones.md).
* The **Phone** page in the sidebar shows a live view of a connected phone, lets you control it by hand and runs the phone agent.

The **Phone** page works on its own. You can watch and control a phone there even when sharing is off.

***

## Phones list

The left column lists the phones connected to this Mac, with the platform next to each name. Select one to see it. New phones appear on their own. Use the refresh button if one is missing.

When no phone is found, the list shows the reason, for example that an iPhone is not paired or that Developer Mode is off. **Add a phone** at the bottom repeats the setup steps.

While an iPhone is being set up you see **Preparing your iPhone** with the current step.

***

## Live view and manual control

The middle of the page shows the phone's screen.

| To do this | Do this |
| - | - |
| Tap | Click the screen |
| Swipe | Drag on the screen |
| Type | Write in **Type on the phone, press Enter…** and press Enter. The text is typed into the focused field on the phone, followed by Enter |
| Go to the Home screen | **Home** |
| Go back (Android) | **Back** |

> [!NOTE]
>
> Your own clicks never ask for approval, because you are the one acting. Approvals apply to agents. Your manual actions do count toward the phone's [rate limit](https://docs.appeeky.com/docs/phones/approvals-and-safety.md#rate-limits).

***

## Agent panel

The right column runs the [phone agent](https://docs.appeeky.com/docs/phones/phone-agent.md) on the selected phone.

1. Write a task in **Tell the agent what to do…**, for example *Open Settings and turn on dark mode*.
2. Choose **Run**, or press Cmd+Enter.
3. Each step appears as it happens, with the action and its result. When the agent finishes, its summary is shown.

Choose **Stop** to end a run.

The agent runs in Appeeky's cloud and reaches the phone through your Mac. If sharing is off, Appeeky Desktop shares your phones for this session so the run can work. Your saved setting does not change.

Taps on buttons like Post, Send or Buy still wait for your approval on the **Phones** page of the web dashboard. See [Approvals and safety](https://docs.appeeky.com/docs/phones/approvals-and-safety.md).


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