# commands

The telescope command, for when you'd rather run things yourself.
## Install

```bash
npm install -g usetelescope
```

Needs Node 20 or later. Or skip the install and use `npx usetelescope <command>`.

## Commands

| Command | What it does |
| --- | --- |
| `telescope login` | Sign in. |
| `telescope up` | Set up or repair the VM for the repo you're in. |
| `telescope ls` | List your projects and their addresses. |
| `telescope link [project]` | Show a QR code to add a phone or browser. |
| `telescope devices [project]` | List devices; `telescope devices revoke <id>` removes one. |
| `telescope env push [project]` | Send your updated env files to the VM. |
| `telescope logs [project]` | Show your VM's logs. |
| `telescope down <project>` | Delete a project's VM and everything on it. |
| `telescope feedback "<message>"` | Tell us what didn't work. |
| `telescope whoami` / `logout` | Your account on this machine. |

## Setup details

`telescope up` reads a small config that says what to run: the app folder, which env files to copy, and any extra services with their start commands. Your agent writes it for you and Telescope stores it with the project, so nothing is added to your repo. Running `telescope up` again reuses it.