CLI

The CLI is intentionally tiny. It's a launcher, not an IDE. Most days the only command you'll type is localuniverse.

`localuniverse`

Opens a browser tab into the hub. If a dev server is running on a known port (3000, 5173, 8080, etc.) it gets auto-detected and shown in your private dev panel. Otherwise the panel stays empty and you can paste a port in later.

localuniverse

# explicit port
localuniverse --port 4321

# explicit URL (e.g. for non-localhost dev servers)
localuniverse --url https://example.local

`localuniverse upgrade`

Updates the CLI to the latest release. Checks for updates against the GitHub release feed; downloads in place.

localuniverse upgrade

`localuniverse logout`

Clears your local session. The next time you run localuniverse, you'll be prompted to log in again.

localuniverse logout

`localuniverse doctor`

Diagnoses common setup issues — missing dependencies, port conflicts, blocked WebRTC, etc. Run this if anything's not working.

localuniverse doctor

Flags

Flag	Description
`--port <n>`	Tell LU which local port to embed in your dev panel
`--url <url>`	Use a non-localhost URL for the dev panel
`--no-browser`	Don't auto-open a browser tab (useful for headless)
`--version`	Print the installed version
`--help`	Show help