# using telescope

The toolbar on your phone, how syncing works, and what to ask your agent.
## Syncing

Your VM shows your agent's newest changes. It syncs when you open the app, when you switch back to it, and when you tap **sync**. Most changes show up in a second or two.

## The toolbar

Tap the small pill floating over your app.

| Control | What it does |
| --- | --- |
| Sync | Pull the newest changes now. |
| Branch | Follow the newest changes automatically, or stay on one branch. |
| Screen size | Laptop, 1440×900 (default), desktop, phone, or fit to your screen. |
| Keep warm | How long the VM stays awake after you leave, up to 30 minutes. |
| Sleep now | Put the VM to sleep right away. |

## Ask your agent

You rarely need to type a command. Ask your agent, and it runs the right one:

| You say | It runs |
| --- | --- |
| "Set up this repo on Telescope" | `telescope up` |
| "What Telescope projects do I have?" | `telescope ls` |
| "I changed my .env, update the preview" | `telescope env push` |
| "Add another phone" | `telescope link` |
| "Which devices can open my preview?" | `telescope devices` |
| "Remove my old iPad" | `telescope devices revoke` |
| "Delete the VM for my-app" | `telescope down my-app`, after checking with you |

## Another phone or tablet

Each device gets its own sign-in. Ask your agent to add one, or run `telescope link`. A QR code opens; scan it within 10 minutes. It works once. Devices stay signed in until they go 30 days unused.

## Sleep

VMs sleep when you're not looking and wake in a few seconds when you open the app. One VM is awake at a time, for up to 4 hours a day. See [help](help.md).