commands

Install

npm install -g usetelescope

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

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.