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.