CLI reference
Everything on wess.dev can be driven from the wess command. Install: curl -fsSL https://wess.dev/install.sh | sh
Commands
| Command | What it does |
|---|---|
wess login | Sign in (flags: -e email -p password, or interactive) |
wess apps | List your apps with status and age |
wess create <name> | Create an app and reserve name.wess.dev |
wess deploy <name> --image <ref> [--port N] | Deploy a prebuilt container image |
wess git <name> | Add the app as a git remote named wess in the current repo |
wess status <name> | URL, image, database, and machines for an app |
wess logs <name> [-f] [-n N] | Show (or follow) app logs |
wess secrets list <app> | List secret names |
wess secrets set <app> KEY VALUE | Set a secret (applies on next deploy) |
wess secrets unset <app> KEY | Remove a secret |
wess open <name> | Open the app in your browser |
wess destroy <name> | Destroy an app, its machines, and its database (asks you to type the app name to confirm) |
Environment
| Variable | Meaning |
|---|---|
WESS_API | API base (default https://wess.dev) |
WESS_TOKEN | Auth token override (otherwise ~/.wess/token) |
The CLI is a single static binary — no runtime needed. Re-run the installer any time to update.