CLI reference

Install: curl -fsSL https://wess.dev/install.sh | sh. Add --json to any command for machine-readable output.

Apps

shell

wess apps                         # list your apps
wess create <name>               # create an app
wess deploy <name> --image <ref> [--port N]
wess git <name>                  # add a `wess` git remote (run inside the repo)
wess status <name>               # url, image, database, machines
wess logs <name> [-f] [-n N]     # show / follow logs
wess open <name>                 # open in your browser
wess destroy <name>              # destroy app, machines, and database (asks to confirm)

Secrets

shell

wess secrets set <app> KEY VALUE
wess secrets list <app>
wess secrets unset <app> KEY

AI, sandbox, doctor

shell

wess ai <app> <anthropic|openai|ollama> [-m model]
wess sandbox <python|node|bun|bash> <file>
wess doctor <app> [-x]           # health report (-x adds an AI explanation)
wess init <name>                 # scaffold a starter project

Tokens (owner)

shell

wess token create <name> --scopes read,deploy [--app <app>]
wess token list
wess token revoke <id>

The wess token CLI requires an owner session. Members create and manage their own tokens in the web console under Settings.